ContentControl 接口

项目
08/12/2011

表示文档中的内容控件。

命名空间： Microsoft.Office.Tools.Word
程序集： Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）

语法

声明
<GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")> _
Public Interface ContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")]
public interface ContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

ContentControl 类型公开以下成员。

属性

	名称	说明
	Application	获取一个表示 Microsoft Office Word 当前实例的 Microsoft.Office.Interop.Word.Application。
	BindingContext	获取或设置 IBindableComponent 的货币管理器的集合。（继承自 IBindableComponent。）
	BuildingBlockCategory	获取或设置在表示生成块库的 ContentControl 中显示的生成块的类别。
	BuildingBlockType	获取或设置在表示生成块库的 ContentControl 中显示的生成块的类型。
	Checked	获取或设置一个值，该值指示 ContentControl（代表复选框控件）已选中还是未选中。此属性只能用于 Word 2010 项目中。
	Container	基础结构。（继承自 ContentControlBase。）
	ContainerComponent	基础结构。（继承自 ContentControlBase。）
	Creator	获取一个 32 位整数，该整数指示已在其中创建 ContentControl 的应用程序。
	DataBindings	获取此 IBindableComponent 的数据绑定对象的集合。（继承自 IBindableComponent。）
	DateCalendarType	获取或设置在表示日期选择器的 ContentControl 中显示的日历的类型。
	DateDisplayFormat	获取或设置一个字符串，该字符串指定在表示日期选择器的 ContentControl 中显示日期的格式。
	DateDisplayLocale	获取或设置在表示日期选择器的 ContentControl 中显示的日期的语言格式。
	DateStorageFormat	获取或设置表示日期选择器的 ContentControl 在自定义 XML 部件中保存日期所用的格式。
	DefaultDataSourceUpdateMode	获取或设置 ContentControlBase 的默认 DataSourceUpdateMode。（继承自 ContentControlBase。）
	DefaultTextStyle	获取用于设置 ContentControl 中的文本格式的字符样式的名称。
	DropDownListEntries	获取由表示下拉列表或组合框的 ContentControl 所显示的项的集合。
	ID	获取标识内容控件的唯一编号。（继承自 ContentControlBase。）
	InnerObject	获取 Microsoft.Office.Tools.Word.ContentControlBase 的基础 Microsoft.Office.Interop.Word.ContentControl 对象。（继承自 ContentControlBase。）
	LockContentControl	获取或设置一个值，该值指定是否可以从文档中删除 ContentControl。
	LockContents	获取或设置一个值，该值指定 ContentControl 的内容是否可以编辑。
	MultiLine	获取或设置一个值，该值指定 ContentControl 是否可以包含分行符。
	Parent	获取 ContentControl 的父级。
	ParentContentControl	获取嵌套在另一个内容控件内的 ContentControl 的父内容控件。
	PlaceholderText	获取在用户操作或某个其他操作更改文本之前在 ContentControl 中显示的文本。
	Range	获取一个表示 ContentControl 的内容的 Range。
	ShowingPlaceholderText	获取一个值，该值指定 ContentControl 当前是否显示占位符文本。
	Site	获取或设置与 IComponent 关联的 ISite。（继承自 IComponent。）
	Tag	获取或设置要与 ContentControl 关联的字符串。
	Temporary	获取或设置一个值，该值指定在编辑 ContentControl 时是否自动将该控件从文档中删除。
	Title	获取或设置 ContentControl 的标题。
	Type	获取或设置一个值，该值指定 ContentControl 所表示的内容控件的类型。
	XMLMapping	获取一个 XMLMapping，该对象表示 ContentControl 与自定义 XML 部件中的某个元素之间的绑定。

页首

方法

	名称	说明
	BeginInit	用信号通知对象初始化即将开始。（继承自 ISupportInitialize。）
	Copy	将 ContentControl 从文档复制到剪贴板。
	Cut	从文档中移除 ContentControl，然后将其添加到剪贴板中。
	Delete	从文档中删除动态创建的内容控件，并将其从文档中的 ControlCollection 中移除。（继承自 ContentControlBase。）
	Dispose	执行与释放或重置非托管资源相关的应用程序定义的任务。（继承自 IDisposable。）
	EndInit	用信号通知对象初始化已完成。（继承自 ISupportInitialize。）
	SetCheckedSymbol	设置用于表示 ContentControl（代表复选框控件）的已选中状态的符号。此方法只能用于 Word 2010 项目中。
	SetPlaceholderText	将 BuildingBlock、Range 或字符串中的文本显示为 ContentControl 中的占位符文本。
	SetUncheckedSymbol	设置用于表示 ContentControl（代表复选框控件）的未选中状态的符号。此方法只能用于 Word 2010 项目中。
	Ungroup	从文档中移除包含 ContentControl 的分组内容控件，以使该区域不再受保护。

页首

事件

	名称	说明
	Added	在内容控件添加到文档后发生。（继承自 ContentControlBase。）
	BindingContextChanged	当 ContentControlBase 的 BindingContext 属性的值更改时发生。（继承自 ContentControlBase。）
	ContentUpdating	如果内容控件绑定到自定义 XML 部件，则此事件在 Microsoft Office Word 更新内容控件中的文本之前发生。（继承自 ContentControlBase。）
	Deleting	在内容控件从文档中删除之前发生。（继承自 ContentControlBase。）
	Disposed	表示处理组件的 Disposed 事件的方法。（继承自 IComponent。）
	Entering	当用户在内容控件中单击，或者以编程方式将光标移到内容控件中时发生。（继承自 ContentControlBase。）
	Exiting	当用户在内容控件外单击，或者以编程方式将光标移出内容控件时发生。（继承自 ContentControlBase。）
	StoreUpdating	就在 Microsoft Office Word 更新绑定到内容控件的自定义 XML 部件中的数据之前（即在内容控件中的文本更改之后）发生。（继承自 ContentControlBase。）
	Validated	在成功验证内容控件时发生。（继承自 ContentControlBase。）
	Validating	在验证内容控件的内容时发生。（继承自 ContentControlBase。）

页首

备注

ContentControl 对象是一种可变控件，它可以表示 Microsoft Office Word 中可使用的八种内容控件类型中的任何一种。例如，如果创建了最初具有纯文本控件功能的 ContentControl，可以在运行时进行更改，使之具有类似于组合框的行为。不能以此方式使用其他内容控件。例如，RichTextContentControl 只能表示多格式文本控件。有关内容控件的更多信息，请参见内容控件。

若要创建 ContentControl，请使用某个 AddContentControl 方法。不能在设计时将 ContentControl 添加到文档。

创建 ContentControl 时，必须指定要创建的内容控件的类型，或者在现有内容控件基础上创建新控件。创建 ContentControl 之后，可以使用 Type 属性来更改它所表示的内容控件的类型。

如果使用某些 ContentControl 成员时，该控件设置为不能使用这些成员的控件类型，则这些成员将引发异常。例如，如果尝试在不表示日期选择器的 ContentControl 上使用 DateCalendarType 属性，则该属性将引发异常。

提示

此接口由 Visual Studio Tools for Office 运行时实现。不应在代码中实现此接口。有关更多信息，请参见 Visual Studio Tools for Office Runtime 概述。

用法

本文档介绍面向 .NET Framework 4 的 Office 项目中所用此类型的版本。在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。有关在面向 .NET Framework 3.5 的项目中使用此类型的文档，请参见 Visual Studio 2008 文档中以下参考部分：https://go.microsoft.com/fwlink/?LinkId=160658。