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);