Document.Controls 屬性

發行項
01/03/2014

取得文件中包含的 Managed 控制項集合。

命名空間： 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 ，包含文件全部的 Managed 控制項。

備註

Office 方案中的文件可以包含 Windows Form 控制項和主控制項。如需詳細資訊，請參閱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());
}