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


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)

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

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

Комментарии

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

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

Свойство Name соответствует ключу для в TreeNodeTreeNodeCollection.

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

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

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

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

Комментарии

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

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

Свойство Name соответствует ключу для в TreeNodeTreeNodeCollection.

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

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

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

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

Комментарии

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

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

Свойство Name соответствует ключу для в TreeNodeTreeNodeCollection.

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

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

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

Комментарии

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

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

Свойство Name соответствует ключу для в TreeNodeTreeNodeCollection.

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

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 для вставки в коллекцию.

Исключения

Значение 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

Комментарии

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

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

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

Примечание

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

Комментарии

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

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

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

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

Комментарии

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

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

Свойство Name соответствует ключу для в TreeNodeTreeNodeCollection.

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

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