コンテンツ コントロールの作業

コンテンツ コントロールとは

コンテンツ コントロールは、特定の種類のコンテンツに対するコンテナーとして機能するドキュメント内にバインドされ、場合によってはラベル付き領域でもあります。 個別のコンテンツ コントロールは、日付、リスト、書式設定されたテキストの段落などのコンテンツを格納できます。 場合によっては、コンテンツ コントロールはフォームを連想させることがあります。 ただし、これにより豊富で構造化されたコンテンツのブロックを作成できるようになるため、より強力かつフレキシブルになり、役立ちます。 コンテンツ コントロールによって、明確に定義されたブロックをドキュメントに挿入するテンプレートを作成できるようになります。 コンテンツ コントロールにより、次のことができるようになります。

• テンプレートに構造化された領域を指定する。 読み取りや書き込みができるように、それぞれの構造化された領域には独自の固有 ID があります。 構造化された領域 (または、コンテンツ コントロール) の種類には、コンボ ボックス、画像、テキスト ブロック、およびカレンダーなどがあります。

• コンテンツ コントロールの動作を決定します。 各コンテンツ コントロールはドキュメントの一部を占め、テンプレート作成者として各リージョンの機能を指定できます。 たとえば、テンプレートの領域を予定表にする場合は、ドキュメントのその領域に予定表コンテンツ コントロールを挿入します。これにより、コンテンツのブロックが何を行うかが自動的に決まります。 同様に、テンプレートのセクションに画像を表示する場合は、その領域に画像コンテンツ コントロールを作成します。 このようにして、定義済みのブロック型を使用してテンプレートを構築できます。

• ドキュメント内のコンテンツ コントロールを変更する機能を制限する。 削除や編集ができないように、各コンテンツ コントロールに制限することができます。 これは例えば、ユーザーが読み取ることはできるが、編集できないテンプレートに著作権情報がある場合に役に立ちます。 また別の例では、テンプレート ドキュメント内に配置したコンテンツ コントロールをロックして、ユーザーがコンテンツ コントロールに含まれるコンテンツを誤って削除しないようにすることもできます。 これにより、テンプレートは以前のバージョンよりも堅牢になります。

• コンテンツ コントロールのコンテンツをカスタム XML パーツのデータにマップする。 例えば、プレーン テキスト コンテンツ コントロールを株価のテーブルのセルに挿入する場合、テーブル セルのコンテンツ コントロールを現在の株価を含む XML ファイルのノードにマップできます。 価格が変わると、アドインはプログラムを使用して添付されている XML ファイル (各プレーン テキスト コンテンツ コントロールにバインドされている) を更新し、その新しく更新された価格が自動的にテーブルに表示されます。

コンテンツ コントロールを最も簡単に作成するには、ユーザー インターフェイスを使用します (プログラムを使用して作成することもできます)。 ユーザー インターフェイス (UI) によってコンテンツ コントロールを作成するには、コンテンツ コントロール (例: テキストや画像) にするコンテンツを選択して、[開発] リボンのコンテンツ コントロール セクションから目的のコンテンツ コントロールの種類を選択します。 これにより選択したコンテンツの周囲にコンテンツ コントロールが作成されます。

Word オブジェクト モデル内のコンテンツ コントロール

次の表は、コンテンツ コントロールに関連付けられている Word オブジェクト モデル内のオブジェクトを示しています。

これらのオブジェクトまたはコレクションにはそれぞれ、個別とコレクションの両方でコンテンツ コントロールを操作できるようにするメソッドとプロパティがあります。 さまざまな種類のコンテンツ コントロールがあるため (次のセクション「コンテンツ コントロールの種類」を参照)、ContentControl オブジェクトにはコンテンツ コントロールの異なる種類すべてに適用できない可能性があるメンバーがあります。 次の表は、コンテンツ コントロールの特定の種類にのみ適用される ContentControl オブジェクトのプロパティおよびメソッドを示しています。

コンテンツ コントロールの種類

ドキュメントに追加できるコンテンツ コントロールには、それぞれ WdContentControlType という新しい列挙体で表される 8 種類のコンテンツ コントロールがあります。

コンテンツ コントロールのイベント

Word のコンテンツ コントロール オブジェクト モデルで使用可能なプロパティおよびメソッドに加えて、コンテンツ コントロールを追加や削除する場合、またはユーザーがコンテンツ コントロールを編集する場合に、イベントを使用してコードを実行できるようにすることもできます。 次のリストには、それぞれのイベント、およびイベント コードを実行するタイミングを示します。 これらすべてのイベントは Document オブジェクトのメンバーです。

コードの操作

コンテンツ コントロールを追加するかどうか、コンテンツ コントロールを削除するかどうか、またコンテンツ コントロールにアクセスして終了の操作をするかどうかは、コードで処理することができます。 次のシナリオは、使用できるサンプルの一部です。

コンテンツ コントロールの追加

上述のとおり、ドキュメントに追加できる 8 種類のコンテンツ コントロールがあります。 ContentControls コレクションの Add メソッドを使用して、ドキュメントにコンテンツ コントロールを追加します。 次の例では、日付の選択をアクティブなドキュメントに追加し、日付の値を現在の日付に設定しています。

Sub AddDatePicker() 
 
    Dim objCC As ContentControl 
    Dim objDate As Date 
 
    Set objCC = ActiveDocument.ContentControls _ 
        .Add(wdContentControlDate) 
    objDate = Date 
    objCC.Range.Text = objDate 
     
End Sub

同じ基本的な構造を使用して、ドキュメントにさまざまな種類のコンテンツ コントロールを追加します。

コンテンツ コントロールにタイトルを追加する

Title プロパティを使用してコンテンツ コントロールにタイトルを追加します。 このテキストがユーザーに表示され、コンテンツ コントロールに入力するデータの種類を確認するのに役立ちます。 次の例では、新しいプレーンテキスト コンテンツ コントロールをアクティブなドキュメントに追加し、コントロールにタイトルを設定 (テキストを表示) しています。

Sub SetTitleForContentControl() 
 
    Dim objCC As ContentControl 
     
    Set objCC = ActiveDocument.ContentControls _ 
        .Add(wdContentControlText) 
         
    objCC.Title = "Please enter your name" 
     
End Sub

コンテンツ コントロールのプレースホルダー テキストを変更する

プレースホルダー テキストは一時テキストです。 1 単語または 2 単語の説明 (タイトルと同様)、またはより完全な説明 (手順番号など) にすることができます。 プレースホルダー テキストの変更は、コンテンツ コントロールの種類やコンテンツ コントロールの予期されるコンテンツに関係なく同じです。 次の例では、アクティブなドキュメントにドロップダウン リストを追加し、コントロールにプレースホルダー テキストを設定して、複数の動物の名前でリストを埋めています。

Sub SetPlaceholderText() 
 
    Dim objCC As ContentControl 
     
    Set objCC = Selection.ContentControls _ 
        .Add(wdContentControlComboBox) 
    objCC.Title = "Favorite Animal" 
    objCC.SetPlaceholderText _ 
        Text:="Please select your favorite animal " 
     
    '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" 
 
End Sub

これらはオブジェクト モデルを使用してドキュメントのコンテンツ コントロールを操作する方法の一部です。 詳細な例については、方法 セクションを参照してください。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。