AlignTablesRowByRow class

Office 2013 and later

Align Table Rows Independently. When the object is serialized out as xml, its qualified name is w:alignTablesRowByRow.

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

No code example is currently available or this language may not be supported.

[ISO/IEC 29500-1 1st Edition]

alignTablesRowByRow (Align Table Rows Independently)

This element specifies whether applications shall align each row within a table independently based on the alignment setting of the jc element (Part 1, §17.4.28) when displaying the contents of a table in a WordprocessingML document.

When the justification of a table using the jc element is typically applied, that alignment is applied to the contents of the table (the table is centered, left justified, or right-aligned), and then individual rows are laid out based on the resulting table's position. This element, when present with a val attribute value of true (or equivalent), specifies that each table row shall be independently aligned based on the table alignment setting, ignoring the placement of all other rows.

[Example: Consider a WordprocessingML document with a single centered table, whose second row is defined such that one-half of an inch is left before the row begins, as follows:

<w:tbl>
  <w:tblPr>
    <w:jc w:val="center" />
  </w:tblPr>
  <w:tr>
    …  </w:tr>
  <w:tr>
    <w:trPr>
      <w:gridBefore w:val="1" /> 
      <w:wBefore w:w="720" w:type="dxa" />
    </w:trPr>
    …  </w:tr>
  <w:tr>
    …  </w:tr>
</w:tbl>

The default presentation would have the entire table centered, then the second row indented beyond that by 720 points:

However, if this compatibility setting is turned on:

<w:compat>
  <w:alignTablesRowByRow />
</w:compat>

Then that second row would instead be centered on the page independently of the other table rows, resulting in the following output:

In this case, the wBefore element's value is ignored, since the row was centered on the line as a row, and there is no table to be indented relative to. 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.

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