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
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
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.
- Code
- Result
// 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);