Document.Controls 属性 (2007 system)
更新: 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());
}
权限
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。
另请参见
参考
Microsoft.Office.Tools.Word 命名空间
其他资源
修订记录
日期 |
修订记录 |
原因 |
---|---|---|
2008 年 7 月 |
添加了一个针对应用程序级外接程序的代码示例版本。 |
SP1 功能更改。 |