w:trPr (Table Row Properties)
Contains formatting properties that apply to the entire table row.
Parent elements
Child elements
Description
w:trPr is the table row properties container, grouping all row-level formatting for a w:tr. It is defined in ECMA-376 Part 1 §17.4.82.
Common children include w:trHeight (row height), w:tblHeader (repeat as header), w:cantSplit (prevent row from breaking across pages), and w:ins/w:del (revision tracking at the row level).
Attributes
| Attribute | Type | Possible Values | Description |
|---|---|---|---|
| (none) | — | — | Properties are expressed exclusively through child elements. |
Examples
<!-- Header row: 600 twips high, repeats on each page -->
<w:trPr>
<w:trHeight w:val="600" w:hRule="exact"/>
<w:tblHeader/>
</w:trPr>
new TableRowProperties(
new TableRowHeight { Val = 600U, HeightType = HeightRuleValues.Exact },
new TableHeader());
<!-- Regular data row: prevent split across pages -->
<w:trPr>
<w:trHeight w:val="720" w:hRule="atLeast"/>
<w:cantSplit/>
</w:trPr>
new TableRowProperties(
new TableRowHeight { Val = 720U, HeightType = HeightRuleValues.AtLeast },
new CantSplit());
Notes
- Height Rules:
auto(fit content),exact(fixed),atLeast(minimum). - Table Header:
w:tblHeaderrepeats row on every page; useful for multi-page tables. - Page Breaks:
w:cantSplitprevents row from breaking across page boundaries. - Row-Level: Properties apply to entire row; cell-level properties override.
- Revision Tracking:
w:ins/w:delchildren track row insertions/deletions. - Property Scope: Contains only metadata; actual row content is in
w:tc(cells). - Compatibility: All Office versions support row properties consistently.