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 ApiTableCellPr class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| nValue | Required | twips | The 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
Set the spacing between the cell content and the top edge of a table cell in a document.
// How do I control the gap between text and the top border of a table cell in a document?
// Push cell content away from the top boundary of a table cell 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);
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);