GetContentControlsByTag

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

语法

expression.GetContentControlsByTag(sTag);

expression - 表示 ApiDocument 类的变量。

参数

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

返回值

ApiBlockLvlSdt[] | ApiInlineLvlSdt[]

示例

查找文档中共享给定标签的所有内容控件。

// How do I select content controls by their tag name in a document?

// Target a specific group of controls using a shared tag to update their properties in a document.

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