ContentControl 介面

表示文件中的內容控制項。

命名空間：  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.Interop.Word.Application，代表 Microsoft Office Word 目前的執行個體。
	BindingContext	取得或設定 IBindableComponent 的 Currency 管理員集合。 (繼承自 IBindableComponent)。
	BuildingBlockCategory	取得或設定顯示在 ContentControl 中的建置組塊 (Building Block) 分類，此分類代表建置組塊陳列庫。
	BuildingBlockType	取得或設定在 ContentControl 中顯示的建置組塊 (Building Block) 之類型，此類型表示建置組塊陳列庫。
	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 的父代 (Parent)。
	ParentContentControl	取得以巢狀方式置於另一個內容控制項中之 ContentControl 的父內容控制項。
	PlaceholderText	取得 ContentControl 中顯示的文字，直到該文字被使用者動作或其他作業變更為止。
	Range	取得 Range，表示 ContentControl 的內容。
	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	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承自 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 只能代表 Rich Text 控制項。 如需內容控制項的詳細資訊，請參閱內容控制項.

若要建立 ContentControl，請使用其中一種 AddContentControl 方法。 您不能在設計階段將 ContentControl 加入至文件。

建立 ContentControl 時，必須指定您要建立之內容控制項的型別，或者可以使用現有的內容控制項做為新控制項的基礎。 建立了 ContentControl 後，可以使用 Type 屬性，變更它所代表的內容控制項型別。

當控制項設定成不是用來使用成員的控制項型別時，如果您使用 ContentControl 成員，其中有些成員會擲回例外狀況。 例如，如果您嘗試在不是代表日期選擇器的 ContentControl 上使用 DateCalendarType 屬性，則該屬性會擲回例外狀況。

注意事項
此介面是由 Visual Studio Tools for Office Runtime 所實作， 並不能實作於您的程式碼中。 如需詳細資訊，請參閱 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 (英文)。

請參閱

參考

Microsoft.Office.Tools.Word 命名空間

其他資源

內容控制項

HOW TO：將內容控制項加入至 Word 文件

HOW TO：使用內容控制項保護文件的部分