Document.Controls 属性

项目
08/12/2011

获取文档中包含的托管控件的集合。

命名空间： Microsoft.Office.Tools.Word
程序集： Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）

语法

声明
ReadOnly Property Controls As ControlCollection
    Get

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());
}