[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
cnfStyle (Paragraph Conditional Formatting)
This element specifies the set of conditional table style formatting properties which have been applied to this paragraph, if this paragraph is contained within a table cell. [Note: This property is an optimization which may be used by consumers to determine if a given property on a paragraph is the result of the table style properties vs. direct formatting on the paragraph itself. end note]
If this property is specified on a paragraph which is not contained within a table cell, then its contents shall be ignored when reading the contents of the document.
[Example: Consider a paragraph in the top right corner of a table with a table style applied. This paragraph would need to specify the following WordprocessingML:
<w:p>
<w:pPr>
<w:cnfStyle w:val="101000000100" />
...
<//w:pPr>
...
</w:p>
This paragraph specifies that it has the conditional properties from the table style for the first column, first row, and the NW corner of the parent table by setting the appropriate bits in the val attribute. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|
val (Conditional Formatting Bit Mask) |
Specifies the set of conditional formatting properties that have been applied to this object.
These properties are expressed using a string serialization of a binary bitmask for each of the following properties (reading from the first character position right):
• First Row - Is this the first row of the table? • Last Row - Is this the last row of the table? • First Column - Does this belong to the first column of the table? • Last Column - Does this belong to the last column of the table? • Band 1 Vertical - Does this belong to a column which should receive band 1 formatting? This property specifies whether the cell should receive the formatting specified for odd-numbered columns (e.g. 1,3,5,...) • Band 2 Vertical - Does this belong to a column which should receive band 2 formatting? This property specifies whether the cell should receive the formatting specified for even-numbered columns (e.g. 2,4,6...) • Band 1 Horizontal - Does this receive band 1 formatting? This property specifies whether the cell should receive the formatting specified for odd-numbered rows (e.g. 1,3,5,...) • Band 2 Horizontal - Does this receive band 2 formatting? This property specifies whether the cell should receive the formatting specified for even-numbered rows (e.g. 2,4,6...) • NE Cell - Is this part of the top-right corner of the table? • NW Cell - Is this part of the top-left corner of the table? • SE Cell - Is this part of the bottom-right corner of the table? • SW Cell - Is this part of the bottom-left corner of the table?
For each of these properties, a value of 1 in the specified character position in the string means that the value is true, a value of 0 means false. All values must be specified.
[Example: Consider a paragraph in the top right corner of a table with a table style applied. This paragraph would need to specify the following WordprocessingML:
<w:p> <w:pPr> <w:cnfStyle w:val="101000000100" /> ... </w:pPr> ... </w:p>
This paragraph specifies that it has the conditional properties from the table style for the first column, first row, and the NW corner of the parent table by setting the appropriate bits in the val attribute. end example]
The possible values for this attribute are defined by the ST_Cnf simple type (§2.18.11). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Cnf">
<attribute name="val" type="ST_Cnf" use="required"/>
</complexType>