ContentControl オブジェクト (Word)
個々のコンテンツ コントロール。 コンテンツ コントロールは、ラベルを付けることのできる、境界線で区切られた文書内の領域で、特定の種類のコンテンツのコンテナーとして機能します。 個々のコンテンツ コントロールには、日付、一覧、書式付き文字列の段落などのコンテンツを含めることができます。 ContentControl オブジェクトは ContentControls コレクションのメンバーです。
注釈
ContentControls コレクションの Add メソッドを使用して、コンテンツ コントロールを作成します。 作成するコンテンツ コントロールの種類を指定するには、 Add メソッドの Type パラメーターを使用します。 次の使用例は、新しいドロップダウン リスト コンテンツ コントロールを作成し、いくつかの項目を一覧に追加します。
Dim objCC As ContentControl
Set objCC = ActiveDocument.ContentControls.Add(Type:=wdContentControlDropdownList)
'List entries
objCC.DropdownListEntries.Add "Cat"
objCC.DropdownListEntries.Add "Dog"
objCC.DropdownListEntries.Add "Horse"
objCC.DropdownListEntries.Add "Monkey"
objCC.DropdownListEntries.Add "Snake"
objCC.DropdownListEntries.Add "Other"
コンテンツ コントロールを別の種類のコンテンツ コントロールに変更するには、 Type プロパティを使用します。 たとえば、日付コントロールからテキスト コントロールに変更する場合があります。 ただし、すべてのコンテンツ コントロールを別の種類に変更できない場合があります。型の変更を許可しない場合があります。 また、コンテンツ コントロールの内容によっては、種類を変更できない場合があります。 たとえば、 に変更するコンテンツ コントロールで、既存のコンテンツ コントロール内にあるコンテンツの種類が許可されていない場合、型の変更は許可されず、実行時エラーが発生します。
次の使用例は、日付コンテンツ コントロールを挿入してコントロールの値を設定し、そのコントロールをテキスト コンテンツ コントロールに変更します。
Dim objCC As ContentControl
Set objCC = ActiveDocument.ContentControls.Add(wdContentControlDate)
objCC.Range.Text = "January 1, 2007"
objCC.Type = wdContentControlText
プレースホルダー テキストを、既定の文字列からそのコントロールに適した文字列に変更するには、SetPlaceholderText メソッドを使用します。 コントロールのタイトル テキストを指定するには、Title プロパティを使用します。 このタイトルは、コントロール内部にカーソルを移動するか、マウス ポインターをコントロール上に置くと、コントロールの上に表示されます。
指定するコンテンツ コントロールの種類によっては、ContentControl オブジェクトの一部のプロパティおよびメソッドを使用できない場合があります。
コンテンツ コントロールのプロパティには、一部の種類のコンテンツ コントロールにしか適用できないものがあります。 プロパティを適用できるコンテンツの種類を次の表に示します。
プロパティ/メソッド | 対象 |
---|---|
BuildingBlockCategory プロパティ | 文書パーツ ギャラリー コンテンツ コントロール (wdContentControlBuildingBlockGallery) |
BuildingBlockType プロパティ | 文書パーツ ギャラリー コンテンツ コントロール (wdContentControlBuildingBlockGallery) |
DateDisplayFormat プロパティ | 日付コンテンツ コントロール (wdContentControlDate) |
DateDisplayLocale プロパティ | 日付コンテンツ コントロール (wdContentControlDate) |
DateStorageFormat プロパティ | 日付コンテンツ コントロール (wdContentControlDate) |
DropdownListEntries プロパティ | コンボ ボックスおよびドロップダウン リストのコンテンツ コントロール (wdContentControlComboBox および wdContentControlDropdownList) |
MultiLine プロパティ | テキスト形式コンテンツ コントロール (wdContentControlText) |
Ungroup メソッド | グループ コンテンツ コントロール (wdContentControlGroup) |
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。