Skip to content

API reference / Common / Engine types / TableCellProperties

Interface: TableCellProperties ​

A cell's own properties (a:tcPr / w:tcPr) — the superset union.

Shared by the two users that genuinely share a schema type: a cell instance (a:tcPr / w:tcPr) and a docx style's w:tcPr — CT_TblStylePr's w:tcPr is CT_TcPr, the instance's own type, so one Rust type is exact there.

A pptx style region is not one of them. Its a:tcStyle is CT_TableStyleCellStyle, which shares only a:cell3D with CT_TableCellProperties: its edges are themeable and it states no margins, anchor or direction at all. That is TableCellStyle, and the cascade binds it into this shape.

Properties ​

PropertyDescription
fill?
PaintFill
EG_FillProperties / w:shd — the cell's background.
borders?
TableCellBorders
a:lnL … / w:tcBorders.
margins?
TableCellMargins
@marL … / w:tcMar — the padding inside the cell.
anchor?
TextAnchor
@anchor / w:vAlign — where the content sits vertically.
anchorCenter?
boolean
@anchorCtr — center the content block horizontally as a unit, rather than aligning each paragraph. pptx-only.
direction?
TextDirection
@vert / w:textDirection — the flow direction inside the cell.
cell3d?
TableCell3D
a:cell3D — the bevel and lighting a DrawingML cell can carry.
width?
TableWidth
w:tcW — the cell's preferred width. docx-only; a pptx cell takes its width from the grid.
wrap?
boolean
w:noWrap, inverted — whether the content wraps. docx-only.
fitText?
boolean
w:tcFitText — shrink the content to fit the cell's width. Resolves to the body's normAutofit, so the existing fit search serves it.
hideMark?
boolean
w:hideMark — ignore an empty cell's end-of-cell mark when measuring the row's height. docx-only.
conditional?
TableConditional
w:cnfStyle — Word's cache of which conditional regions it decided apply here. Preserved for round-trip and not read: the resolver computes the regions from the cell's position and the table's look, and that computation wins on disagreement.
headers?
string[]
a:headers / w:headers — the ids of the header cells this one is described by, for assistive technology.