Поделиться через


ControlExtensions.AddTreeView - метод (ControlCollection, Range, Single, Single, String)

Добавляет в заданное расположение в документе новый элемент управления 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, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As TreeView
public static TreeView AddTreeView(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

Параметры

  • controls
    Тип: Microsoft.Office.Tools.Word.ControlCollection
    Коллекция, в которую добавляется элемент управления.Не формируйте значение этого параметра самостоятельно.При вызове этого метода для коллекции, возвращаемой свойством Document.Controls (в проекте уровня приложения) или свойством DocumentBase.Controls (в проекте уровня документа), данный параметр предоставляется автоматически.
  • 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 или range равен nullпустая ссылка (Nothing в Visual Basic), или аргумент name имеет нулевую длину.

ControlNameAlreadyExistsException

Элемент управления с таким именем уже имеется в данном экземпляре класса ControlCollection.

InvalidRangeException

Указанный диапазон не существует.

Заметки

Этот метод используется для добавления объектов TreeView в конец коллекции ControlCollection.

Чтобы удалить добавленный программно элемент управления TreeView, воспользуйтесь методом Remove.

Примеры

В приведенном ниже примере кода в первый абзац документа добавляется элемент управления TreeView, после чего в этот элемент управления добавляется родительский узел с двумя дочерними узлами. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.

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

Безопасность платформы .NET Framework

См. также

Ссылки

ControlExtensions Класс

AddTreeView - перегрузка

Microsoft.Office.Tools.Word - пространство имен