Document.Controls 属性 (2007 system)

项目
09/04/2008

更新： 2008 年 7 月

获取文档中的所有 Windows 窗体控件和宿主控件的集合。

命名空间： 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 窗体控件和宿主控件。

备注

作为 Visual Studio Tools for Office 中的文档级自定义项的一部分的文档可以显示 Windows 窗体控件和宿主控件。有关更多信息，请参见 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());
}