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 content of a shape in a document.

// How do I add a paragraph at the end of a shape's content in a document?

// Clear a shape's existing content and place a fresh paragraph inside it to replace all prior text.

let doc = Api.GetDocument();
let paragraph = doc.GetElement(0);
let fill = Api.CreateSolidFill(Api.RGB(255, 111, 61));
let stroke = Api.CreateStroke(0, Api.CreateNoFill());
let drawing = Api.CreateShape("rect", 3212465, 963295, fill, stroke);
paragraph.AddDrawing(drawing);
let docContent = drawing.GetDocContent();
docContent.RemoveAllElements();
paragraph = Api.CreateParagraph();
paragraph.SetJc("left");
paragraph.AddText("We removed all elements from the shape and added a new paragraph inside it.");
docContent.Push(paragraph);