Push

推送段落或表格以将其实际添加到文档中。

语法

expression.Push(oElement);

expression - 表示 ApiDocumentContent 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
oElement	必需	DocumentElement		将推送到文档的元素类型。

返回值

boolean

示例

向演示文稿中形状文本内容的末尾添加新段落。

// 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);