Skip to main content

SetCellMarginTop

Specifies an amount of space which will be left between the upper extent of the cell contents and the border of a specific table cell within a table.

Inherited from ApiTableCellPr.SetCellMarginTop.

Syntax​

expression.SetCellMarginTop(nValue);

expression - A variable that represents an ApiTableCell class.

Parameters​

NameRequired/OptionalData typeDefaultDescription
nValueRequiredtwipsThe value for the amount of space above the upper extent of the cell measured in twentieths of a point (1/1440 of an inch). If this value is null, then default table cell top margin will be used, otherwise the table cell top margin will be overridden with the specified value for the current cell.

Returns​

boolean

Example​

Set the spacing between the cell content and its top edge in a document.

// How do I add padding above the text inside a table cell in a document?

// Push the content away from the top border by controlling the inner gap in a document.

let doc = Api.GetDocument();
let paragraph = doc.GetElement(0);
let tableStyle = doc.CreateStyle("CustomTableStyle", "table");
tableStyle.SetBasedOn(doc.GetStyle("Bordered"));
let table = Api.CreateTable(3, 3);
table.SetWidth("percent", 100);
let cell = table.GetRow(0).GetCell(0);
cell.SetCellMarginTop(720);
cell.GetContent().GetElement(0).AddText("This is just a sample text to show that the top cell margin is 36 points.");
table.SetStyle(tableStyle);
doc.Push(table);