GetContentControlsByTag

返回文档中具有指定标签名称的所有内容控件的列表。

语法

expression.GetContentControlsByTag(sTag);

expression - 表示 ApiDocument 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
sTag	必需	string		内容控件标签。

返回值

ApiBlockLvlSdt[] | ApiInlineLvlSdt[]

示例

此示例展示如何获取文档中具有指定标签名称的所有内容控件列表。

// Retrieve each content control with the specified tag.

// Get the first content control with the tag and set its alias.

let doc = Api.GetDocument();
let paragraph = doc.GetElement(0);
let inlineLvlSdt = Api.CreateInlineLvlSdt();
paragraph.AddInlineLvlSdt(inlineLvlSdt);
inlineLvlSdt.AddText("Inline content control");
inlineLvlSdt.SetTag("Tag 1");
let blockLvlSdt = Api.CreateBlockLvlSdt();
blockLvlSdt.GetContent().GetElement(0).AddText("Block text content control");
blockLvlSdt.SetTag("Tag 2");
doc.AddElement(0, blockLvlSdt);
let contentControls = doc.GetContentControlsByTag("Tag 1");
contentControls[0].SetAlias("№1");