ContentControl 接口

定义

命名空间:

Microsoft.Office.Interop.Word

程序集:

Microsoft.Office.Interop.Word.dll

单个内容控件。 内容控件是文档中绑定的、有可能添加标签的区域，它们充当特定类型的内容的容器。 单个内容控件可能包含诸如日期、列表或格式化文本段落等内容。 ContentControl 对象是 集合的成员ContentControls。

public interface class ContentControl

[System.Runtime.InteropServices.Guid("EE95AFE3-3026-4172-B078-0E79DAB5CC3D")]
public interface ContentControl

type ContentControl = interface

Public Interface ContentControl

属性

GuidAttribute

注解

Add(WdContentControlType, Object)使用 集合的 ContentControls 方法创建内容控件。 Type使用 Add 方法的 参数指定要创建的内容控件的类型。

Type使用 属性将内容控件更改为不同类型的内容控件。 例如，你也许要从日期控件更改为文本控件。 但是，你可能无法将所有内容控件更改为其他类型；某些控件可能不允许更改其类型。 此外，根据内容控件的内容，可能无法更改类型。 例如，想要更改的内容控件不允许使用现有内容控件中的内容类型，如果尝试更改类型是不允许的，并且将产生运行时错误。

SetPlaceholderText(BuildingBlock, Range, String)使用 方法将占位符文本从默认字符串更改为更适合控件的内容。 Title使用 属性指定控件的标题文本。 当光标定位在控件内部或鼠标指针置于控件上时，这些内容将显示在控件上。

根据所拥有的内容控件的类型，你可能无法使用 ContentControl 对象的所有属性和方法。

并非所有内容控件属性都适用于所有不同类型的内容控件。 下表列出了哪些属性适用于哪些类型的内容控件。

	BuildingBlockCategory 财产	BuildingBlock 库内容控件 (wdContentControlBuildingBlockGallery)
	BuildingBlockType 财产	BuildingBlock 库内容控件 (wdContentControlBuildingBlockGallery)
	DateDisplayFormat 财产	日期内容控件 (wdContentControlDate)
	DateDisplayLocale 财产	日期内容控件 (wdContentControlDate)
	DateStorageFormat 财产	日期内容控件 (wdContentControlDate)
	DropdownListEntries 财产	组合框和下拉列表内容控件 (wdContentControlComboBox 和 wdContentControlDropdownList)
	MultiLine 财产	纯文本内容控件 (wdContentControlText)
	Ungroup() 方法	将内容控件 (wdContentControlGroup) 分组

属性

AllowInsertDeleteSection	获取或设置用户是否可以使用用户界面在指定的重复节内容控件中添加或删除节。
Appearance	返回或设置内容控件的外观。 读/写 WdContentControlAppearance
Application	返回一个_Application对象，该对象表示 Microsoft Word 应用程序。
BuildingBlockCategory	返回或设置构建基块内容控件的类别。 读/写。
BuildingBlockType	返回或设置构建基块内容控件的构建基块的类型。 读/写。
Checked	获取或设置检查框的当前状态 (选中/未选中) 。
Color	返回或设置内容控件的颜色。 读/写 WdColor。
Creator	返回一个 32 位整数，它指示在其中创建外接程序的应用程序。 此为只读属性。
DateCalendarType	返回或设置日历内容控件的日历类型。 读/写。
DateDisplayFormat	返回或设置日期的显示格式。 读/写。
DateDisplayLocale	返回日期内容控件中显示的日期的语言格式。 读/写。
DateStorageFormat	返回或设置日期内容控件绑定到活动文档的 XML 数据存储时用于存储和检索日期的格式。 读/写。
DefaultTextStyle	返回或设置用于设置文本内容控件中文本格式的字符样式的名称。 读/写。
DropdownListEntries	返回下拉列表内容控件或组合框内容控件中的项。 此为只读属性。
ID	返回内容控件的标识。 此为只读属性。
Level	返回内容控件的级别 - 内容控件是包围文本、段落、表格单元格还是表行;或内联时。 只读 WdContentControlLevel。
LockContentControl	返回或设置一个 boolean 类型的值 ，该值表示用户能否从活动文档中删除内容控件。 读/写。
LockContents	返回或设置一个 boolean 类型的值 ，该值表示用户能否编辑内容控件的内容。 读/写。
MultiLine	返回一个 boolean 类型的值 ，该值表示一个文本内容控件是否允许多行文本。 读/写。
Parent	返回一个 ，该值代表指定 ContentControl 对象的父对象。
ParentContentControl	返回嵌套在富文本控件或组控件内的内容控件的父内容控件。 此为只读属性。
PlaceholderText	返回一个 BuildingBlock 对象，该对象代表内容控件的占位符文本。 此为只读属性。
Range	返回一个 Range ，它表示活动文档中的内容控件的内容。 此为只读属性。
RepeatingSectionItems	返回指定重复节内容控件中重复节项的集合。 此为只读属性。
RepeatingSectionItemTitle	返回或设置与指定的重复节内容控件关联的上下文菜单中使用的重复节项的名称。 读/写。
ShowingPlaceholderText	返回一个 boolean 类型的值 ，该值指示是否显示占位符文本的内容控件。 此为只读属性。
Tag	返回或设置一个值来标识内容控件。 读/写。
Temporary	返回或设置一个 boolean 类型的值 ，该值代表是否从活动文档中删除内容控件，当用户编辑控件的内容。 读/写。
Title	返回或设置内容控件的标题。 读/写。
Type	返回或设置内容控件的类型。 读/写。
XMLMapping	返回内容控件到文档数据存储中的 XML 数据的映射。 此为只读属性。

方法

Copy()	将活动文档中的内容控件复制到剪贴板。
Cut()	从活动文档中删除内容控件并将该内容控件移动到剪贴板中。
Delete(Boolean)	删除指定的内容控件以及内容控件中的内容。
SetCheckedSymbol(Int32, String)	设置用于代表复选框内容控件的选中状态的符号。
SetPlaceholderText(BuildingBlock, Range, String)	设置在用户输入自己的文本之前显示在内容控件中的占位符文本。
SetUncheckedSymbol(Int32, String)	设置用于代表复选框内容控件的未选中状态的符号。
Ungroup()	从文档中删除一个组内容控件，以便它的子内容控件不再嵌套，并且可以自由地进行编辑。