AddElement
Adds an element to the current paragraph.
Syntax
expression.AddElement(oElement, nPos);
expression - A variable that represents a ApiParagraph class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| oElement | Required | ParagraphContent | The document element which will be added at the current position. Returns false if the oElement type is not supported by a paragraph. | |
| nPos | Optional | number | The position where the current element will be added. If this value is not specified, then the element will be added at the end of the current paragraph. |
Returns
boolean
Example
This example adds a run to the paragraph.
- Code
- Result
// Insert a text run to the ApiParagraph object.
// How to add the ApiRun object to the slide.
const presentation = Api.GetPresentation();
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();
const gs1 = Api.CreateGradientStop(Api.CreateRGBColor(255, 213, 191), 0);
const gs2 = Api.CreateGradientStop(Api.CreateRGBColor(255, 111, 61), 100000);
const fill = Api.CreateRadialGradientFill([gs1, gs2]);
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();
const paragraph = docContent.GetElement(0);
const run = Api.CreateRun();
run.AddText("This is the text for a text run. Nothing special.");
paragraph.AddElement(run);
slide.AddObject(shape);