DoNotBreakWrappedTables Class

Do Not Allow Floating Tables To Break Across Pages.When the object is serialized out as xml, its qualified name is w:doNotBreakWrappedTables.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.OnOffType
        DocumentFormat.OpenXml.Wordprocessing.DoNotBreakWrappedTables

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class DoNotBreakWrappedTables _
    Inherits OnOffType
'Usage
Dim instance As DoNotBreakWrappedTables
public class DoNotBreakWrappedTables : OnOffType

Remarks

[ISO/IEC 29500-1 1st Edition]

9.7.3.10 doNotBreakWrappedTables (Do Not Allow Floating Tables To Break Across Pages)

This element specifies whether applications shall allow tables which have been set to floating using the tblpPr element (Part 1, §17.4.58) shall be allowed to break across multiple pages when needed.

Typically, a table whose contents cannot all be displayed on one page is broken as needed across multiple pages in order to preserve the location of the table (just as a paragraph of multiple lines is broken across pages as needed). This element, when present with a val attribute value of true (or equivalent), specifies that floating tables shall never be broken across pages, and shall instead be put on the first page by adjusting the starting position of the table as needed to fit on that single page.

[Example: Consider a WordprocessingML document with a floating table positioned at the bottom of a page , as follows:

DocumentFormat.OpenXml.Wordprocessing.DoNotBreakWr

The default presentation of this document results in that table being broken across two pages of content.

However, if this compatibility setting is turned on:

<w:compat>
<w:doNotBreakWrappedTables />
</w:compat>

Then that table is not broken across the page boundary, so it must be moved further up on the first page to accommodate its entire size, resulting in the following output:

DocumentFormat.OpenXml.Wordprocessing.DoNotBreakWr

Notice that the table now flows into the page margins in order to keep it on one page. end example]

Parent Elements

compat (Part 1, §17.15.1.21)

This element’s content model is defined by the common boolean property definition in Part 1, §17.17.4.

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

DoNotBreakWrappedTables Members

DocumentFormat.OpenXml.Wordprocessing Namespace