API reference / Common / Engine types / TableRegularRow

Interface: TableRegularRow

One row (a:tr / w:tr): its identity, its properties, and its cells.

The grid is dense — a cell's column is grid_before + index, so the layout finds a cell's rect by lookup rather than by search. The index is its place among grid_cells, which descends through any content control in cells; a control contributes no column. A row need not span the whole grid, because docx lets one start late or stop early, so the invariant is grid_cells().count() == columns.len() - grid_before - grid_after. pptx has no equivalent and both are zero there.

The importer enforces it: real files break it, and w:tblGrid is the authority when a row disagrees.

Properties

Property	Description
id string	Stable model id.
properties? TableRowProperties	a:tr@h / w:trPr, plus the w:tblPrEx that hangs beside it.
cells TableCell[]	The cells, left to right — EG_ContentCellContent, so a member may wrap cells rather than be one. One cell per grid column the row covers.