Skip to main content

Push

Pushes a paragraph or a table to actually add it to the document.

Syntax

expression.Push(oElement);

expression - A variable that represents a ApiDocumentContent class.

Parameters

NameRequired/OptionalData typeDefaultDescription
oElementRequiredDocumentElementThe element type which will be pushed to the document.

Returns

boolean

Example

Append a new paragraph to the end of a shape's content in a spreadsheet.

// How do I add a paragraph to the bottom of a shape's text area in a spreadsheet?

// Build a paragraph separately and place it at the end of a shape in a spreadsheet.

let worksheet = Api.GetActiveSheet();
let fill = Api.CreateSolidFill(Api.RGB(255, 111, 61));
let stroke = Api.CreateStroke(0, Api.CreateNoFill());
let shape = worksheet.AddShape("flowChartOnlineStorage", 60 * 36000, 35 * 36000, fill, stroke, 0, 2 * 36000, 0, 3 * 36000);
let content = shape.GetContent();
content.RemoveAllElements();
let paragraph = Api.CreateParagraph();
paragraph.SetJc("left");
paragraph.AddText("We removed all elements from the shape and added a new paragraph inside it.");
content.Push(paragraph);