ContentControl インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
個々のコンテンツ コントロール。 コンテンツ コントロールは、ラベルを付けることのできる、境界線で区切られた文書内の領域で、特定の種類のコンテンツのコンテナーとして機能します。 個々のコンテンツ コントロールには、日付、一覧、書式付き文字列の段落などのコンテンツを含めることができます。 ContentControl オブジェクトは、コレクションのContentControlsメンバーです。
public interface class ContentControl[System.Runtime.InteropServices.Guid("EE95AFE3-3026-4172-B078-0E79DAB5CC3D")]
public interface ContentControltype ContentControl = interfacePublic Interface ContentControl- 属性
注釈
コレクションの Add(WdContentControlType, Object) メソッドを ContentControls 使用して、コンテンツ コントロールを作成します。 Add メソッドのパラメーターをType使用して、作成するコンテンツ コントロールの種類を指定します。
プロパティを 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 |
コンテンツ コントロールの ID を返します。 読み取り専用です。 |
| Level |
コンテンツ コントロールのレベル (コンテンツ コントロールがテキスト、段落、表のセル、またはテーブル行を囲むかどうか) を返します。またはインラインの場合は 。 読み取り専用 WdContentControlLevelです。 |
| LockContentControl |
取得または設定する ブール値 をユーザーが作業中の文書からコンテンツ コントロールを削除できるかどうかを表します。 値の取得と設定が可能です。 |
| LockContents |
取得または設定する ブール値 をユーザーがコンテンツ コントロールの内容を編集できるかどうかを表します。 値の取得と設定が可能です。 |
| MultiLine |
返しますが、 ブール値 のテキスト コンテンツ コントロールかどうかを表すには、複数行のテキストが使用できます。 値の取得と設定が可能です。 |
| Parent |
指定した ContentControl オブジェクトの親オブジェクトを表す を返します。 |
| ParentContentControl |
リッチ テキスト コントロールまたはグループ コントロール内に入れ子になっているコンテンツ コントロールの親コンテンツ コントロールを返します。 読み取り専用です。 |
| PlaceholderText |
コンテンツ コントロールの BuildingBlock プレースホルダー テキストを表す オブジェクトを返します。 読み取り専用。 |
| Range |
作業中の Range 文書のコンテンツ コントロールの内容を表す を返します。 読み取り専用です。 |
| RepeatingSectionItems |
指定した繰り返しセクション コンテンツ コントロール内の繰り返しセクション項目のコレクションを返します。 読み取り専用です。 |
| RepeatingSectionItemTitle |
指定した繰り返しセクション コンテンツ コントロールに関連付けられているコンテキスト メニューで使用される繰り返しセクション項目の名前を設定または返します。 値の取得と設定が可能です。 |
| ShowingPlaceholderText |
ブール値 をコンテンツ コントロールのプレース ホルダー テキストが表示されるかどうかを示す値を返します。 読み取り専用です。 |
| Tag |
コンテンツ コントロールを識別する値を設定または返します。 値の取得と設定が可能です。 |
| Temporary |
ブール値 を表すユーザー コントロールの内容を編集するときに、作業中の文書からコンテンツ コントロールを削除するかどうかを設定または返します。 値の取得と設定が可能です。 |
| Title |
コンテンツ コントロールのタイトルを設定または返します。 値の取得と設定が可能です。 |
| Type |
コンテンツ コントロールの型を設定または返します。 値の取得と設定が可能です。 |
| XMLMapping |
ドキュメントのデータ ストア内の XML データへのコンテンツ コントロールのマッピングを返します。 読み取り専用です。 |
メソッド
| Copy() |
作業中の文書のコンテンツ コントロールをクリップボードにコピーします。 |
| Cut() |
作業中の文書からコンテンツ コントロールを削除し、コンテンツ コントロールをクリップボードに移動します。 |
| Delete(Boolean) |
指定したコンテンツ コントロールおよびコンテンツ コントロールの内容を削除します。 |
| SetCheckedSymbol(Int32, String) |
チェック ボックス コンテンツ コントロールのオン状態を表す記号を設定します。 |
| SetPlaceholderText(BuildingBlock, Range, String) |
ユーザーが独自の文字列を入力するまでコンテンツ コントロールに表示されるプレースホルダー文字列を設定します。 |
| SetUncheckedSymbol(Int32, String) |
チェック ボックス コンテンツ コントロールのオフ状態を表す記号を設定します。 |
| Ungroup() |
文書からグループ コンテンツ コントロールを削除し、その子コンテンツ コントロールのネスト状態を解除して自由に編集できるようにします。 |