TreeNodeCollection.Insert Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Вставляет элемент в коллекцию в указанном расположении.

Перегрузки

Имя	Описание
Insert(Int32, String, String, String, String)	Создает узел дерева с указанным ключом, текстом и изображениями и вставляет его в коллекцию по указанному индексу.
Insert(Int32, String, String, Int32, Int32)	Создает узел дерева с указанным ключом, текстом и изображениями и вставляет его в коллекцию по указанному индексу.
Insert(Int32, String, String, String)	Создает узел дерева с указанным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.
Insert(Int32, String, String)	Создает узел дерева с указанным текстом и ключом и вставляет его в коллекцию.
Insert(Int32, TreeNode)	Вставляет существующий узел дерева в коллекцию узлов дерева в указанном расположении.
Insert(Int32, String)	Создает узел дерева с указанным текстом и вставляет его по указанному индексу.
Insert(Int32, String, String, Int32)	Создает узел дерева с указанным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.

Insert(Int32, String, String, String, String)

Исходный код:

TreeNodeCollection.cs

Создает узел дерева с указанным ключом, текстом и изображениями и вставляет его в коллекцию по указанному индексу.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey, System::String ^ selectedImageKey);

public virtual System.Windows.Forms.TreeNode Insert(int index, string? key, string? text, string? imageKey, string? selectedImageKey);

abstract member Insert : int * string * string * string * string -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string * string * string -> System.Windows.Forms.TreeNode

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String, selectedImageKey As String) As TreeNode

Параметры

index

Int32

Расположение в коллекции для вставки узла.

key

String

Имя узла дерева.

text

String

Текст, отображаемый в узле дерева.

imageKey

String

Ключ изображения, отображаемого на узле дерева.

selectedImageKey

String

Ключ изображения, отображаемого в узле дерева, когда он находится в выбранном состоянии.

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

TreeNode

Объект TreeNode , вставленный в коллекцию.

Комментарии

Sorted Если для свойства задано trueзначение, index значение параметра игнорируется. Он TreeNode вставляется в представление дерева и TreeView снова сортируется.

Вы также можете добавить новые TreeNode объекты в коллекцию с помощью Add методов или AddRange методов.

Свойство Name соответствует ключу для объекта TreeNode в TreeNodeCollection.

Параметр imageKey ссылается на изображение в ImageList свойстве родительского TreeViewэлемента.

Параметр selectedimageKey ссылается на изображение в StateImageList свойстве родительского TreeViewэлемента.

Insert(Int32, String, String, Int32, Int32)

Исходный код:

TreeNodeCollection.cs

Создает узел дерева с указанным ключом, текстом и изображениями и вставляет его в коллекцию по указанному индексу.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex, int selectedImageIndex);

public virtual System.Windows.Forms.TreeNode Insert(int index, string? key, string? text, int imageIndex, int selectedImageIndex);

abstract member Insert : int * string * string * int * int -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string * int * int -> System.Windows.Forms.TreeNode

Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer, selectedImageIndex As Integer) As TreeNode

Параметры

index

Int32

Расположение в коллекции для вставки узла.

key

String

Имя узла дерева.

text

String

Текст, отображаемый в узле дерева.

imageIndex

Int32

Индекс изображения, отображаемого на узле дерева.

selectedImageIndex

Int32

Индекс изображения, отображаемого в узле дерева, когда он находится в выбранном состоянии.

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

TreeNode

Объект TreeNode , вставленный в коллекцию.

Комментарии

Sorted Если для свойства задано trueзначение, index значение параметра игнорируется. Он TreeNode вставляется в представление дерева и TreeView снова сортируется.

Вы также можете добавить новые TreeNode объекты в коллекцию с помощью Add методов или AddRange методов.

Свойство Name соответствует ключу для объекта TreeNode в TreeNodeCollection.

Параметр imageIndex ссылается на изображение в ImageList свойстве родительского TreeViewэлемента.

Параметр selectedimageIndex ссылается на изображение в StateImageList свойстве родительского TreeViewэлемента.

Insert(Int32, String, String, String)

Исходный код:

TreeNodeCollection.cs

Создает узел дерева с указанным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.TreeNode Insert(int index, string? key, string? text, string? imageKey);

abstract member Insert : int * string * string * string -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string * string -> System.Windows.Forms.TreeNode

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As TreeNode

Параметры

index

Int32

Расположение в коллекции для вставки узла.

key

String

Имя узла дерева.

text

String

Текст, отображаемый в узле дерева.

imageKey

String

Ключ изображения, отображаемого на узле дерева.

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

TreeNode

Объект TreeNode , вставленный в коллекцию.

Комментарии

Sorted Если для свойства задано trueзначение, index значение параметра игнорируется. Он TreeNode вставляется в представление дерева и TreeView снова сортируется.

Вы также можете добавить новые TreeNode объекты в коллекцию с помощью Add методов или AddRange методов.

Свойство Name соответствует ключу для объекта TreeNode в TreeNodeCollection.

Параметр imageKey ссылается на изображение в ImageList свойстве родительского TreeViewэлемента.

Insert(Int32, String, String)

Исходный код:

TreeNodeCollection.cs

Создает узел дерева с указанным текстом и ключом и вставляет его в коллекцию.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text);

public virtual System.Windows.Forms.TreeNode Insert(int index, string? key, string? text);

abstract member Insert : int * string * string -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string -> System.Windows.Forms.TreeNode

Public Overridable Function Insert (index As Integer, key As String, text As String) As TreeNode

Параметры

index

Int32

Расположение в коллекции для вставки узла.

key

String

Имя узла дерева.

text

String

Текст, отображаемый в узле дерева.

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

TreeNode

Объект TreeNode , вставленный в коллекцию.

Комментарии

Sorted Если для свойства задано trueзначение, index значение параметра игнорируется. Он TreeNode вставляется в представление дерева и TreeView снова сортируется.

Вы также можете добавить новые TreeNode объекты в коллекцию с помощью Add методов или AddRange методов.

Свойство Name соответствует ключу для объекта TreeNode в TreeNodeCollection.

Insert(Int32, TreeNode)

Исходный код:

TreeNodeCollection.cs

Вставляет существующий узел дерева в коллекцию узлов дерева в указанном расположении.

public:
 virtual void Insert(int index, System::Windows::Forms::TreeNode ^ node);

public virtual void Insert(int index, System.Windows.Forms.TreeNode node);

abstract member Insert : int * System.Windows.Forms.TreeNode -> unit
override this.Insert : int * System.Windows.Forms.TreeNode -> unit

Public Overridable Sub Insert (index As Integer, node As TreeNode)

Параметры

index

Int32

Индексированное расположение в коллекции для вставки узла дерева.

node

TreeNode

Вставка TreeNode в коллекцию.

Исключения

ArgumentException

В node настоящее время назначается другому TreeView.

Примеры

Следующий пример кода удаляет выбранный узел дерева из одного TreeView и добавляет его в другой, если обе коллекции узлов дерева не доступны только для чтения. Button При щелчке TreeView.SelectedNodeTreeNode свойство удаляется из одного TreeView с помощью Remove метода и добавляется к другому TreeViewInsert с помощью метода. В этом примере требуется, чтобы у вас был объект Form , содержащий два TreeView элемента управления и a Button. Элементы TreeView управления должны быть именованы treeView1 и treeView2.

void button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // If neither TreeNodeCollection is read-only, move the
   // selected node from treeView1 to treeView2.
   if (  !treeView1->Nodes->IsReadOnly &&  !treeView2->Nodes->IsReadOnly )
   {
      if ( treeView1->SelectedNode != nullptr )
      {
         TreeNode^ tn = treeView1->SelectedNode;
         treeView1->Nodes->Remove( tn );
         treeView2->Nodes->Insert( treeView2->Nodes->Count, tn );
      }
   }
}

private void button1_Click(object sender, EventArgs e)
{
   // If neither TreeNodeCollection is read-only, move the 
   // selected node from treeView1 to treeView2.
   if(!treeView1.Nodes.IsReadOnly && !treeView2.Nodes.IsReadOnly)
   {
      if(treeView1.SelectedNode != null)
      {
         TreeNode tn = treeView1.SelectedNode;
         treeView1.Nodes.Remove(tn);
         treeView2.Nodes.Insert(treeView2.Nodes.Count, tn);
      }
   }
}

Private Sub button1_Click(sender As Object, e As EventArgs) Handles button1.Click
   ' If neither TreeNodeCollection is read-only, move the 
   ' selected node from treeView1 to treeView2. 
   If Not treeView1.Nodes.IsReadOnly And Not treeView2.Nodes.IsReadOnly Then
      If (treeView1.SelectedNode IsNot Nothing) Then
         Dim tn As TreeNode = treeView1.SelectedNode
         treeView1.Nodes.Remove(tn)
         treeView2.Nodes.Insert(treeView2.Nodes.Count, tn)
      End If
   End If
End Sub

Комментарии

TreeView.Sorted Если для свойства задано trueзначение, index значение параметра игнорируется. Он TreeNode вставляется в представление дерева и TreeView применяется.

Вы также можете добавить новые TreeNode объекты в коллекцию с помощью Add методов или AddRange методов.

Чтобы удалить добавленный TreeNode ранее объект, используйте RemoveRemoveAtметоды или Clear методы.

Замечание

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

Insert(Int32, String)

Исходный код:

TreeNodeCollection.cs

Создает узел дерева с указанным текстом и вставляет его по указанному индексу.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ text);

public virtual System.Windows.Forms.TreeNode Insert(int index, string? text);

abstract member Insert : int * string -> System.Windows.Forms.TreeNode
override this.Insert : int * string -> System.Windows.Forms.TreeNode

Public Overridable Function Insert (index As Integer, text As String) As TreeNode

Параметры

index

Int32

Расположение в коллекции для вставки узла.

text

String

Текст, отображаемый в узле дерева.

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

TreeNode

Объект TreeNode , вставленный в коллекцию.

Комментарии

Sorted Если для свойства задано trueзначение, index значение параметра игнорируется. Он TreeNode вставляется в представление дерева и TreeView снова сортируется.

Вы также можете добавить новые TreeNode объекты в коллекцию с помощью Add методов или AddRange методов.

Insert(Int32, String, String, Int32)

Исходный код:

TreeNodeCollection.cs

Создает узел дерева с указанным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.TreeNode Insert(int index, string? key, string? text, int imageIndex);

abstract member Insert : int * string * string * int -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string * int -> System.Windows.Forms.TreeNode

Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As TreeNode

Параметры

index

Int32

Расположение в коллекции для вставки узла.

key

String

Имя узла дерева.

text

String

Текст, отображаемый в узле дерева.

imageIndex

Int32

Индекс изображения, отображаемого на узле дерева.

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

TreeNode

Объект TreeNode , вставленный в коллекцию.

Комментарии

Sorted Если для свойства задано trueзначение, index значение параметра игнорируется. Он TreeNode вставляется в представление дерева и TreeView снова сортируется.

Вы также можете добавить новые TreeNode объекты в коллекцию с помощью Add методов или AddRange методов.

Свойство Name соответствует ключу для объекта TreeNode в TreeNodeCollection.

Параметр imageIndex ссылается на изображение в ImageList свойстве родительского TreeViewэлемента.