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)

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

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

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, вставленный в коллекцию.

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

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

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

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, вставленный в коллекцию.

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

Insert(Int32, String, String, String)

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

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

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, вставленный в коллекцию.

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

Insert(Int32, String, String)

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

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

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, вставленный в коллекцию.

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

Insert(Int32, TreeNode)

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

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 объекта объект , представленный TreeNode свойством TreeView.SelectedNode , удаляется из одного TreeView с помощью Remove метода и добавляется в другой TreeView с помощью Insert метода . В этом примере требуется, чтобы у вас был объект Form , содержащий два TreeView элемента управления и 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

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

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

Insert(Int32, String)

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

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

public virtual System.Windows.Forms.TreeNode Insert (int index, 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, вставленный в коллекцию.

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

Insert(Int32, String, String, Int32)

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

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, вставленный в коллекцию.

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

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

TreeNodeCollection.Insert Метод

Определение

Перегрузки

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)

Параметры

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

Комментарии

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

Дополнительные ресурсы