[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
doNotBreakConstrainedForcedTable (Don't Break Table Rows Around Floating Tables)
This element specifies whether applications shall allow a table row to be split in two when its contents are displayed under the following circumstances:
• The table row exceeds one page in height (it must be split into two pages)
• The table row would need to be split in order to accommodate a floating table also on the page (tables which have been set to floating using the tblpPr element (§2.4.54))
Typically, assuming the cantSplit property (§2.4.6) is not set, a table row which cannot fit on one single page shall be split as needed around any floating table on a page, in order to allow its contents to be fully displayed across two or more pages. This element, when present with a val attribute value of true (or equivalent), specifies that table rows which exceed one page in height shall never be split around floating tables in the document, and shall instead be displayed on the first page below the floating table, even if that means that part of the table row is clipped by the edge of the page.
[Example: Consider a WordprocessingML document with a long single table row which must be split across two separate pages in the document, in order to accommodate a floating table anchored in the footer, as follows:
The default presentation of this document forces that row to be split as needed around that floating table.
However, if this compatibility setting is turned on:
<w:compat>
<w:dontBreakConstrainedForcedTable />
</w:compat>
Then that table row is never split around the floating table, so it is always placed below that floating table on the page, and allowed to flow off the page as needed, resulting in the following output:
This example, while extreme, shows how the row is placed below the floating table, rather than breaking around it. end example]
Parent Elements |
compat (§2.15.3.9) |
Attributes |
Description |
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element.
A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.
A value of off, 0, or false specifies that the property shall be explicitly turned off.
[Example: For example, consider the following on/off property:
<w:… w:val="off"/>
The val attribute explicitly declares that the property is turned off. end example]
The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>