DocumentID: ECMA-376/Part4/2.4.7
Title: ECMA-376, Part4: 2.4.7 cnfStyle (Table Cell Conditional Formatting)
Extracted-From: ECMA-376 Office Open XML File Formats, 1st Edition / December 2006
Warning: Coverted to HTML format by a script known to have bugs
Navigation:

2.4.7 cnfStyle (Table Cell Conditional Formatting)

This element specifies the set of conditional table style formatting properties which have been applied to this table cell. [Note: This property is an optimization which is used by consumers to determine if a given property on a table cell is the result of the table style conditional formatting properties vs. direct formatting on the table cell itself. It specifies the components of the conditional formatting in the table style applied to this cell, so that the table's conditional formatting can be applied after the document is displayed without having the table style properties override the style hierarchy. end note]

If this element is omitted, then its value shall be assumed to be zero for all entries in the bit mask.

[Example: Consider a table cell in the top right corner of a table with a table style applied. This table cell would need to specify the following WordprocessingML to express that fact:

<w:tc>

  <w:tcPr>

    <w:cnfStyle w:val="101000000100" />

    ...

  </w:tcPr>

  ...

</w:tc>

This table cell specifies that it has the conditional properties from the table style for the first column, first row, and the top left corner of the parent table by setting the appropriate bits in the val attribute. end example]

Parent Elements

tcPr (§2.7.5.8); tcPr (§2.4.66); tcPr (§2.7.5.9); tcPr (§2.4.67)

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>

Converted to HTML format by ooxmlspec2html 0.1, a Perl script provided by OpenISO.org.