Document.Controls プロパティ

文書にあるマネージ コントロールのコレクションを取得します。

名前空間:  Microsoft.Office.Tools.Word
アセンブリ:   Microsoft.Office.Tools.Word.v4.0.Utilities (Microsoft.Office.Tools.Word.v4.0.Utilities.dll 内)
  Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll 内)

構文

'宣言
ReadOnly Property Controls As ControlCollection

ControlCollection Controls { get; }

プロパティ値

型 : Microsoft.Office.Tools.Word.ControlCollection
文書にあるすべてのマネージ コントロールが格納された ControlCollection。

解説

Office ソリューションのドキュメントには、Windows フォーム コントロールおよびホスト コントロールを含めることができます。詳細については、「Office ドキュメントのコントロール」を参照してください。

実行時にドキュメント上のコントロールを管理するには、Controls プロパティによって返される ControlCollection オブジェクトのメソッドとプロパティを使用します。詳細については、「実行時の Office ドキュメントへのコントロールの追加」を参照してください。

例

次のコード例では、最初の段落にテキストを追加し、その段落を囲む Bookmark コントロールを作成します。この後、文書でのコントロールの総数を示すメッセージ ボックスを表示します。この例は、アプリケーション レベルのアドインのために作成されています。

Private Sub DocumentControls()
    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphAfter()
    vstoDoc.Paragraphs(1).Range.Text = "This is some sample text."
    vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs(1).Range, "Bookmark1")
    System.Windows.Forms.MessageBox.Show("Total number of controls: " & _
                                         vstoDoc.Controls.Count.ToString())
End Sub

private void DocumentControls()
{
    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphAfter();
    vstoDoc.Paragraphs[1].Range.Text = "This is some sample text.";
    vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs[1].Range, "Bookmark1");
    System.Windows.Forms.MessageBox.Show("Total number of controls: " +
        vstoDoc.Controls.Count.ToString());
}

.NET Framework セキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

Document インターフェイス

Microsoft.Office.Tools.Word 名前空間

その他の技術情報

Office ドキュメントのコントロール

実行時の Office ドキュメントへのコントロールの追加