Class TableCellStyle

Styling for table cells.

Inheritance
System.Object
TableCellStyle
Implements
IronSoftware.Abstractions.Word.ITableCellStyle
IronSoftware.Abstractions.Word.IDerivedStyle
IronSoftware.Abstractions.Word.IStyle
IronSoftware.Abstractions.Word.IWordDocumentObjectProperty
IronSoftware.Abstractions.IDocumentObjectProperty
Namespace: IronWord.Models
Assembly: IronWord.dll
Syntax
public class TableCellStyle : Object, ITableCellStyle, IDerivedStyle

TableCellStyle is the styling record a developer assigns to a table cell to control its margins and width without touching the cell's content. One instance gathers the padding and sizing for a cell into a single object, so the same settings can be applied consistently across many cells. It is what the Style property of a TableCell holds.

The padding inside a cell is set through TopMargin, BottomMargin, LeftMargin, and RightMargin, which control the space between each cell border and its contents. Width sets the cell's width. These are the practical levers for spacing table content cleanly, and because they live on a separate style object, a developer can build one TableCellStyle and reuse it rather than repeating margin values on every cell.

TableCellStyle also participates in IronWord's derived-style model: BaseStyle points at a style this one builds on, and InheritedStyle exposes the effective settings after inheritance is resolved, so a cell style can extend a shared base while overriding only the margins it needs. Construct a TableCellStyle, set the margins and width you want, and assign it to a cell's Style property to apply the spacing. Consistent cell padding is what keeps a table from looking cramped, so applying the same style across a column or a whole table gives content room to breathe without setting margins cell by cell. When a table needs a couple of cells to differ, those cells take their own TableCellStyle while the rest share a common one, and the derived-style model resolves the result so each cell reports its effective spacing through InheritedStyle.

using IronWord.Models;

TableCell cell = new Table(2, 2)[0, 0];
cell.Style = new TableCellStyle
{
    LeftMargin = 120,
    RightMargin = 120
};

The add a table how-to covers cell styling alongside table layout, the add table example saves a populated grid to DOCX, and the document element tutorial shows where cell styling fits the document model.

Constructors

TableCellStyle()

Initializes a new instance of TableCellStyle.

Declaration
public TableCellStyle()

Properties

BaseStyle

The original base style definition a style is based off of.

Declaration
public IBaseStyle BaseStyle { get; set; }
Property Value
Type Description
IBaseStyle

BottomMargin

Declaration
public Nullable<uint> BottomMargin { get; set; }
Property Value
Type Description
System.Nullable<System.UInt32>

InheritedStyle

The styling of the table this table cell is a part of.

Declaration
public ITableStyle InheritedStyle { get; }
Property Value
Type Description
ITableStyle

LeftMargin

Declaration
public Nullable<uint> LeftMargin { get; set; }
Property Value
Type Description
System.Nullable<System.UInt32>

RightMargin

Declaration
public Nullable<uint> RightMargin { get; set; }
Property Value
Type Description
System.Nullable<System.UInt32>

TopMargin

Declaration
public Nullable<uint> TopMargin { get; set; }
Property Value
Type Description
System.Nullable<System.UInt32>

Width

Declaration
public Nullable<long> Width { get; set; }
Property Value
Type Description
System.Nullable<System.Int64>

Implements

IronSoftware.Abstractions.Word.ITableCellStyle
IronSoftware.Abstractions.Word.IDerivedStyle
IronSoftware.Abstractions.Word.IStyle
IronSoftware.Abstractions.Word.IWordDocumentObjectProperty
IronSoftware.Abstractions.IDocumentObjectProperty