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)

另请参阅

Word 对象模型参考

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。