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.

Syntax​

expression.SetCellMarginTop(nValue);

expression - A variable that represents a 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 <code>null</code>, 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​

This example 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.

// How to add margin to the top of the cell.

// Create a 3x3 table and add the top cell margin.

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);
let cell = table.GetRow(0).GetCell(0);
cell.GetContent().GetElement(0).AddText("This is just a sample text to show that the top margin for all the table cells is 36 points.");
table.SetWidth("percent", 100);
let tableCellPr = tableStyle.GetTableCellPr();
tableCellPr.SetCellMarginTop(720);
table.SetStyle(tableStyle);
doc.Push(table);