Document.Controls 屬性 (2007 系統)

發行項
08/21/2008

更新： 2008 年 7 月

取得文件中所有 Windows Form 控制項和主控制項的集合。

命名空間： Microsoft.Office.Tools.Word
組件： Microsoft.Office.Tools.Word.v9.0 (在 Microsoft.Office.Tools.Word.v9.0.dll 中)

語法

<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Controls As ControlCollection

Dim instance As Document
Dim value As ControlCollection

value = instance.Controls

[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }

屬性值

型別：Microsoft.Office.Tools.Word.ControlCollection

ControlCollection，包含文件中的所有 Windows Form 控制項和主控制項。

備註

在 Visual Studio Tools for Office 中，屬於文件層級自訂之一部分的文件可以顯示 Windows Form 控制項和主控制項。如需詳細資訊，請參閱 Office 文件上的控制項。

當多個控制項加入至文件時，每一個控制項都是文件的 ControlCollection 成員。

您可以使用 ControlCollection 類別中提供的方法，將控制項加入至 ControlCollection 或將其移除。如需詳細資訊，請參閱在執行階段將控制項加入至 Office 文件。

範例

下列程式碼範例會將文字加入至第一個段落，然後建立內含該段落的 Bookmark 控制項。然後程式碼會顯示訊息方塊，說明文件上的控制項總數。

這是示範文件層級自訂的版本。

Private Sub DocumentControls()
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(1).Range.Text = "This is some sample text."
    Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    MessageBox.Show("Total number of controls: " & Me.Controls.Count.ToString())
End Sub

private void DocumentControls()
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[1].Range.Text = "This is some sample text.";
    this.Controls.AddBookmark(this.Paragraphs[1].Range, "Bookmark1");
    MessageBox.Show("Total number of controls: " +
        this.Controls.Count.ToString());
}

這是示範應用程式層級增益集的版本。

Private Sub DocumentControls()
    Dim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
    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 = this.Application.ActiveDocument.GetVstoObject();
    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());
}