ContentControl 对象 (Word)
单个内容控件。 内容控件是文档中绑定的、有可能添加标签的区域,它们充当特定类型的内容的容器。 单个内容控件可能包含诸如日期、列表或格式化文本段落等内容。 ContentControl 对象是 ContentControls 集合的成员。
备注
使用 ContentControls 集合的 Add 方法创建内容控件。 使用 Add 方法的 Type 参数指定要创建的内容控件的类型。 下例创建新的下拉列表内容控件,然后向列表中添加几个项目。
Dim objCC As ContentControl
Set objCC = ActiveDocument.ContentControls.Add(Type:=wdContentControlDropdownList)
'List entries
objCC.DropdownListEntries.Add "Cat"
objCC.DropdownListEntries.Add "Dog"
objCC.DropdownListEntries.Add "Horse"
objCC.DropdownListEntries.Add "Monkey"
objCC.DropdownListEntries.Add "Snake"
objCC.DropdownListEntries.Add "Other"
使用 Type 属性将内容控件更改为其他类型的内容控件。 例如,你也许要从日期控件更改为文本控件。 但是,你可能无法将所有内容控件更改为其他类型;某些控件可能不允许更改其类型。 此外,根据内容控件的内容,可能无法更改类型。 例如,想要更改的内容控件不允许使用现有内容控件中的内容类型,如果尝试更改类型是不允许的,并且将产生运行时错误。
以下示例插入一个日期内容控件并且设置其值,然后将该控件更改为文本内容控件。
Dim objCC As ContentControl
Set objCC = ActiveDocument.ContentControls.Add(wdContentControlDate)
objCC.Range.Text = "January 1, 2007"
objCC.Type = wdContentControlText
使用 SetPlaceholderText 方法将占位符文本从默认字符串更改为更适合控件的内容。 使用 Title 属性指定控件的标题文本。 当光标定位在控件内部或鼠标指针置于控件上时,这些内容将显示在控件上。
根据所拥有的内容控件的类型,你可能无法使用 ContentControl 对象的所有属性和方法。
并非所有内容控件属性都适用于所有不同类型的内容控件。 下表列出了哪些属性适用于哪些类型的内容控件。
属性/方法 | 应用于 |
---|---|
BuildingBlockCategory 属性 | BuildingBlock 库内容控件 (wdContentControlBuildingBlockGallery) |
BuildingBlockType 属性 | BuildingBlock 库内容控件 (wdContentControlBuildingBlockGallery) |
DateDisplayFormat 属性 | 日期内容控件 (wdContentControlDate) |
DateDisplayLocale 属性 | 日期内容控件 (wdContentControlDate) |
DateStorageFormat 属性 | 日期内容控件 (wdContentControlDate) |
DropdownListEntries 属性 | 组合框和下拉列表内容控件(wdContentControlComboBox 和 wdContentControlDropdownList) |
MultiLine 属性 | 纯文本内容控件 (wdContentControlText) |
Ungroup 方法 | 组内容控件 (wdContentControlGroup) |
另请参阅
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。