AddElement
Adds a paragraph or a table or a blockLvl content control using its position in the document content.
Syntax
expression.AddElement(nPos, oElement);
expression - A variable that represents a ApiDocumentContent class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| nPos | Required | number | The position where the current element will be added. | |
| oElement | Required | DocumentElement | The document element which will be added at the current position. |
Returns
boolean
Example
This example adds a paragraph to presentation.
- Code
- Result
// How to create an element, add it to a shape and insert the shape to the slide.
// Create a shape, insert a paragraph to it and then add the shape to the slide.
const presentation = Api.GetPresentation();
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();
const fill = Api.CreateSolidFill(Api.CreateRGBColor(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);