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 Word の現在のインスタンスを表す Microsoft.Office.Interop.Word.Application を取得します。 | |
BindingContext | IBindableComponent の CurrencyManager のコレクションを取得または設定します。 (IBindableComponent から継承されます。) | |
BuildingBlockCategory | ビルド ブロック ギャラリを表す ContentControl に表示されるビルド ブロックのカテゴリを取得または設定します。 | |
BuildingBlockType | ビルド ブロック ギャラリーを表す ContentControl に表示されるビルド ブロックの種類を取得または設定します。 | |
Checked | チェック ボックス コントロールを表す ContentControl がオンとオフのどちらになっているかを示す値を取得または設定します。このプロパティは Word 2010 プロジェクトのみで使用できます。 | |
Container | インフラストラクチャ。 (ContentControlBase から継承されます。) | |
ContainerComponent | インフラストラクチャ。 (ContentControlBase から継承されます。) | |
Creator | ContentControl が作成されたアプリケーションを示す 32 ビット整数を取得します。 | |
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 | ContentControl とカスタム XML 部分にある要素の間のバインディングを表す XMLMapping を取得します。 |
このページのトップへ
メソッド
名前 | 説明 | |
---|---|---|
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 | コンテンツ コントロールにバインドされているカスタム XML 部分にあるデータを Microsoft Office Word が更新する直前 (コンテンツ コントロール内のテキストが変更された後) に発生します。 (ContentControlBase から継承されます。) | |
Validated | コンテンツ コントロールの検証が正常に完了したときに発生します。 (ContentControlBase から継承されます。) | |
Validating | コンテンツ コントロール内のコンテンツを検証中であるときに発生します。 (ContentControlBase から継承されます。) |
このページのトップへ
解説
ContentControl オブジェクトは変更可能なコントロールで、Microsoft Office Word で使用できる 8 種類のコンテンツ コントロールのすべてを表すことができます。 たとえば、最初にプレーンテキスト コントロールの機能を持つ 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 を参照してください。
参照
参照
Microsoft.Office.Tools.Word 名前空間