ControlExtensions.AddTreeView Метод

Определение

Перегрузки

AddTreeView(ControlCollection, Range, Single, Single, String)

Добавляет в заданное расположение документа новый элемент управления TreeView указанного размера.Adds a new TreeView control to the document in the specified size and location.

AddTreeView(ControlCollection, Single, Single, Single, Single, String)

Добавляет в заданное расположение документа новый элемент управления TreeView указанного размера.Adds a new TreeView control to the document in the specified size and location.

AddTreeView(ControlCollection, Range, Single, Single, String)

Добавляет в заданное расположение документа новый элемент управления TreeView указанного размера.Adds a new TreeView control to the document in the specified size and location.

public static Microsoft.Office.Tools.Word.Controls.TreeView AddTreeView (this Microsoft.Office.Tools.Word.ControlCollection controls, Microsoft.Office.Interop.Word.Range range, float width, float height, string name);

Параметры

controls
ControlCollection

Коллекция, в которую добавляется элемент управления.The collection to add the control to. Не предоставляйте этот параметр вручную.Do not supply this parameter yourself. При вызове этого метода для коллекции, возвращаемой свойством Controls (в проекте уровня приложения) или свойством Controls (в проекте уровня документа), данный параметр предоставляется автоматически.When you call this method on the collection returned by the Controls property (in an application-level project) or the Controls property (in a document-level project), this parameter is supplied automatically.

range
Range

Расположение элемента управления.The location of the control.

width
Single

Ширина элемента управления в пунктах.The width of the control in points.

height
Single

Высота элемента управления в пунктах.The height of the control in points.

name
String

Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.The name that can be used to index the control in the ControlCollection instance.

Возвращаемое значение

TreeView

Элемент управления, добавленный в документ.The control that was added to the document.

Исключения

Аргумент name или range равен null, или аргумент name имеет нулевую длину.The name or range argument is null, or the name argument has zero length.

Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.A control with the same name is already in the ControlCollection instance.

Указанный диапазон не существует.The range that was specified is not valid.

Примеры

В следующем примере кода элемент управления добавляется в TreeView первый абзац документа, а затем в элемент управления добавляется родительский узел и два дочерних узла.The following code example adds a TreeView control to the first paragraph in the document, and then adds a parent node and two child nodes to the control. Чтобы использовать этот пример, запустите его из ThisDocument класса в проекте уровня документа.To use this example, run it from the ThisDocument class in a document-level project.

private void WordRangeAddTreeView()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.TreeView
         treeView1 = this.Controls.AddTreeView(
         this.Paragraphs[1].Range, 90.75F, 72.75F, "treeView1");

    treeView1.Nodes.Add("Customer Name");
    treeView1.Nodes[0].Nodes.Add("First Name");
    treeView1.Nodes[0].Nodes.Add("Last Name");
}
Private Sub WordRangeAddTreeView()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim TreeView1 As Microsoft.Office.Tools.Word.Controls. _
        TreeView = Me.Controls.AddTreeView(Me.Paragraphs(1). _
        Range, 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 

Комментарии

Этот метод позволяет добавлять TreeView объекты в конец ControlCollection .This method enables you to add TreeView objects to the end of the ControlCollection.

Чтобы удалить TreeView элемент управления, который был добавлен программно, используйте Remove метод.To remove a TreeView control that was added programmatically, use the Remove method.

Применяется к

AddTreeView(ControlCollection, Single, Single, Single, Single, String)

Добавляет в заданное расположение документа новый элемент управления TreeView указанного размера.Adds a new TreeView control to the document in the specified size and location.

public static Microsoft.Office.Tools.Word.Controls.TreeView AddTreeView (this Microsoft.Office.Tools.Word.ControlCollection controls, float left, float top, float width, float height, string name);

Параметры

controls
ControlCollection

Коллекция, в которую добавляется элемент управления.The collection to add the control to. Не предоставляйте этот параметр вручную.Do not supply this parameter yourself. При вызове этого метода для коллекции, возвращаемой свойством Controls (в проекте уровня приложения) или свойством Controls (в проекте уровня документа), данный параметр предоставляется автоматически.When you call this method on the collection returned by the Controls property (in an application-level project) or the Controls property (in a document-level project), this parameter is supplied automatically.

left
Single

Расстояние в пунктах между левым краем элемента управления и левым краем документа.The distance in points between the left edge of the control and the left edge of the document.

top
Single

Расстояние в пунктах между верхним краем элемента управления и верхним краем документа.The distance in points between the top edge of the control and the top edge of the document.

width
Single

Ширина элемента управления в пунктах.The width of the control in points.

height
Single

Высота элемента управления в пунктах.The height of the control in points.

name
String

Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.The name that can be used to index the control in the ControlCollection instance.

Возвращаемое значение

TreeView

Элемент управления, добавленный в документ.The control that was added to the document.

Исключения

Аргумент name равен null или имеет нулевую длину.The name argument is null or has zero length.

Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.A control with the same name is already in the ControlCollection instance.

Примеры

В следующем примере кода в документ добавляется TreeView элемент управления, а затем в элемент управления добавляется родительский узел и два дочерних узла.The following code example adds a TreeView control to the document, and then adds a parent node and two child nodes to the control. Чтобы использовать этот пример, запустите его из ThisDocument класса в проекте уровня документа.To use this example, run it from the ThisDocument class in a document-level project.

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

Комментарии

Этот метод позволяет добавлять TreeView объекты в конец ControlCollection .This method enables you to add TreeView objects to the end of the ControlCollection.

Чтобы удалить TreeView элемент управления, который был добавлен программно, используйте Remove метод.To remove a TreeView control that was added programmatically, use the Remove method.

Применяется к