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
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| oElement | Required | DocumentElement | The element type which will be pushed to the document. |
Returns
boolean
Example
Add a new paragraph to the end of a shape's text content in a presentation.
// How do I append a new paragraph to a shape's existing content in a presentation?
// Get a shape, clear its existing text, and add a new paragraph with text to it.
const presentation = Api.GetPresentation();
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();
const fill = Api.CreateSolidFill(Api.RGB(255, 111, 61));
const stroke = Api.CreateStroke(0, Api.CreateNoFill());
const shape = Api.CreateShape("flowChartMagneticTape", 300 * 36000, 130 * 36000, fill, stroke);
shape.SetPosition(608400, 1267200);
const docContent = shape.GetDocContent();
docContent.RemoveAllElements();
const paragraph = Api.CreateParagraph();
paragraph.AddText("We removed all elements from the shape and added a new paragraph inside it.");
docContent.AddElement(paragraph);
docContent.Push(paragraph);
slide.AddObject(shape);