按照指定的大小和位置向文档中添加一个新的 TreeView 控件。
命名空间:  Microsoft.Office.Tools.Word
程序集:  Microsoft.Office.Tools.Word.v4.0.Utilities(在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中)
语法
声明
<ExtensionAttribute> _
Public Shared Function AddTreeView ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As TreeView
public static TreeView AddTreeView(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)
参数
- controls
 类型:Microsoft.Office.Tools.Word.ControlCollection
 要添加控件的集合。不需要您自己提供此参数。对 Document.Controls 属性(在应用程序级项目中)或 DocumentBase.Controls 属性(在文档级项目中)返回的集合调用此方法时,将自动提供此参数。
- left
 类型:System.Single
 控件左边缘与文档左边缘之间的距离(以磅为单位)。
- top
 类型:System.Single
 控件上边缘和文档上边缘之间的距离(以磅为单位)。
- width
 类型:System.Single
 控件的宽度(以磅为单位)。
- height
 类型:System.Single
 控件的高度(以磅为单位)。
- name
 类型:System.String
 可用于索引 ControlCollection 实例中控件的名称。
返回值
类型:Microsoft.Office.Tools.Word.Controls.TreeView
添加到文档的控件。
使用说明
在 Visual Basic 和 C# 中,可以在 ControlCollection 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时,请省略第一个参数。有关更多信息,请参见扩展方法 (Visual Basic)或扩展方法(C# 编程指南)。
异常
| 异常 | 条件 | 
|---|---|
| ArgumentNullException | name 参数为 nullnull 引用(在 Visual Basic 中为 Nothing) 或长度为零。 | 
| ControlNameAlreadyExistsException | ControlCollection 实例中已存在一个同名控件。 | 
备注
使用此方法可以将 TreeView 对象添加到 ControlCollection 的末尾。
若要移除通过编程方式添加的 TreeView 控件,请使用 Remove 方法。
示例
下面的代码示例向文档中添加一个 TreeView 控件,然后向该控件添加一个父节点和两个子节点。 若要使用此示例,请从文档级项目内的 ThisDocument 类中运行此示例。
Private Sub WordAddTreeView()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim TreeView1 As Microsoft.Office.Tools.Word.Controls. _
        TreeView = Me.Controls.AddTreeView(0, 0, 90.75F, _
        72.75F, "TreeView1")
    TreeView1.Nodes.Add("Customer Name")
    TreeView1.Nodes(0).Nodes.Add("First Name")
    TreeView1.Nodes(0).Nodes.Add("Last Name")
End Sub 
private void WordAddTreeView()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.TreeView
         treeView1 = this.Controls.AddTreeView(
         0, 0, 90.75F, 72.75F, "treeView1");
    treeView1.Nodes.Add("Customer Name");
    treeView1.Nodes[0].Nodes.Add("First Name");
    treeView1.Nodes[0].Nodes.Add("Last Name");
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。