Compartir vía


TreeNodeCollection.Insert Método

Definición

Inserta un elemento en la colección en la ubicación especificada.

Sobrecargas

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

Crea un nodo de árbol con la clave, texto e imágenes especificados y lo inserta en la colección en el índice especificado.

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

Crea un nodo de árbol con la clave, texto e imágenes especificados y lo inserta en la colección en el índice especificado.

Insert(Int32, String, String, String)

Crea un nodo de árbol con la clave, texto e imagen especificados y lo inserta en la colección en el índice especificado.

Insert(Int32, String, String)

Crea un nodo de árbol con el texto y clave especificados y lo inserta en la colección.

Insert(Int32, TreeNode)

Inserta un nodo de árbol existente en la ubicación especificada de la colección de nodos de árbol.

Insert(Int32, String)

Crea un nodo de árbol con el texto especificado y lo inserta en el índice especificado.

Insert(Int32, String, String, Int32)

Crea un nodo de árbol con la clave, texto e imagen especificados y lo inserta en la colección en el índice especificado.

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

Crea un nodo de árbol con la clave, texto e imágenes especificados y lo inserta en la colección en el índice especificado.

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

Parámetros

index
Int32

Ubicación en la colección donde se va a insertar el nodo.

key
String

Nombre del nodo de árbol.

text
String

Texto que se va a mostrar en el nodo de árbol.

imageKey
String

Clave de la imagen que se va a mostrar en el nodo de árbol.

selectedImageKey
String

Clave de la imagen que se va a mostrar en el nodo de árbol cuando está en un estado seleccionado.

Devoluciones

Control TreeNode insertado en la colección.

Comentarios

Si la Sorted propiedad se establece trueen , se omite el valor del index parámetro. TreeNode se inserta en la vista de árbol y TreeView se vuelve a ordenar.

También puede agregar nuevos TreeNode objetos a la colección mediante los Add métodos o AddRange .

La Name propiedad corresponde a la clave de en TreeNode .TreeNodeCollection

El imageKey parámetro hace referencia a una imagen de la ImageList propiedad del elemento primario TreeView.

El selectedimageKey parámetro hace referencia a una imagen de la StateImageList propiedad del elemento primario TreeView.

Se aplica a

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

Crea un nodo de árbol con la clave, texto e imágenes especificados y lo inserta en la colección en el índice especificado.

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

Parámetros

index
Int32

Ubicación en la colección donde se va a insertar el nodo.

key
String

Nombre del nodo de árbol.

text
String

Texto que se va a mostrar en el nodo de árbol.

imageIndex
Int32

Índice de la imagen que se va a mostrar en el nodo de árbol.

selectedImageIndex
Int32

Índice de la imagen que se va a mostrar en el nodo de árbol cuando está en un estado seleccionado.

Devoluciones

Control TreeNode insertado en la colección.

Comentarios

Si la Sorted propiedad se establece trueen , se omite el valor del index parámetro. TreeNode se inserta en la vista de árbol y TreeView se vuelve a ordenar.

También puede agregar nuevos TreeNode objetos a la colección mediante los Add métodos o AddRange .

La Name propiedad corresponde a la clave de en TreeNode .TreeNodeCollection

El imageIndex parámetro hace referencia a una imagen de la ImageList propiedad del elemento primario TreeView.

El selectedimageIndex parámetro hace referencia a una imagen de la StateImageList propiedad del elemento primario TreeView.

Se aplica a

Insert(Int32, String, String, String)

Crea un nodo de árbol con la clave, texto e imagen especificados y lo inserta en la colección en el índice especificado.

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

Parámetros

index
Int32

Ubicación en la colección donde se va a insertar el nodo.

key
String

Nombre del nodo de árbol.

text
String

Texto que se va a mostrar en el nodo de árbol.

imageKey
String

Clave de la imagen que se va a mostrar en el nodo de árbol.

Devoluciones

Control TreeNode insertado en la colección.

Comentarios

Si la Sorted propiedad se establece trueen , se omite el valor del index parámetro. TreeNode se inserta en la vista de árbol y TreeView se vuelve a ordenar.

También puede agregar nuevos TreeNode objetos a la colección mediante los Add métodos o AddRange .

La Name propiedad corresponde a la clave de en TreeNode .TreeNodeCollection

El imageKey parámetro hace referencia a una imagen de la ImageList propiedad del elemento primario TreeView.

Se aplica a

Insert(Int32, String, String)

Crea un nodo de árbol con el texto y clave especificados y lo inserta en la colección.

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

Parámetros

index
Int32

Ubicación en la colección donde se va a insertar el nodo.

key
String

Nombre del nodo de árbol.

text
String

Texto que se va a mostrar en el nodo de árbol.

Devoluciones

Control TreeNode insertado en la colección.

Comentarios

Si la Sorted propiedad se establece trueen , se omite el valor del index parámetro. TreeNode se inserta en la vista de árbol y TreeView se vuelve a ordenar.

También puede agregar nuevos TreeNode objetos a la colección mediante los Add métodos o AddRange .

La Name propiedad corresponde a la clave de en TreeNode .TreeNodeCollection

Se aplica a

Insert(Int32, TreeNode)

Inserta un nodo de árbol existente en la ubicación especificada de la colección de nodos de árbol.

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)

Parámetros

index
Int32

Ubicación indizada de la colección donde se va a insertar el nodo de árbol.

node
TreeNode

TreeNode que se va a insertar en la colección.

Excepciones

El node está asignado actualmente a otro control TreeView.

Ejemplos

En el ejemplo de código siguiente se quita el nodo de árbol seleccionado de uno TreeView y se agrega a otro si ambas colecciones de nodos de árbol no son de solo lectura. Cuando se hace clic en , Button el TreeNode representado por la TreeView.SelectedNode propiedad se elimina de uno TreeView mediante el Remove método y se agrega al otro TreeView mediante el Insert método . En este ejemplo se requiere que tenga un Form que contenga dos TreeView controles y .Button Los TreeView controles deben tener el nombre treeView1 y 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

Comentarios

Si la TreeView.Sorted propiedad se establece trueen , se omite el valor del index parámetro. TreeNode se inserta en la vista de árbol y TreeView el recurso.

También puede agregar nuevos TreeNode objetos a la colección mediante los Add métodos o AddRange .

Para quitar un TreeNode objeto que agregó anteriormente, use los Removemétodos , RemoveAto Clear .

Nota:

Solo TreeNode se puede asignar a un TreeView control a la vez. Para agregar el nodo de árbol a un nuevo control de vista de árbol, primero debe quitarlo de la otra vista de árbol o clonarlo.

Se aplica a

Insert(Int32, String)

Crea un nodo de árbol con el texto especificado y lo inserta en el índice especificado.

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

Parámetros

index
Int32

Ubicación en la colección donde se va a insertar el nodo.

text
String

Texto que se va a mostrar en el nodo de árbol.

Devoluciones

Control TreeNode insertado en la colección.

Comentarios

Si la Sorted propiedad se establece trueen , se omite el valor del index parámetro. TreeNode se inserta en la vista de árbol y TreeView se vuelve a ordenar.

También puede agregar nuevos TreeNode objetos a la colección mediante los Add métodos o AddRange .

Se aplica a

Insert(Int32, String, String, Int32)

Crea un nodo de árbol con la clave, texto e imagen especificados y lo inserta en la colección en el índice especificado.

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

Parámetros

index
Int32

Ubicación en la colección donde se va a insertar el nodo.

key
String

Nombre del nodo de árbol.

text
String

Texto que se va a mostrar en el nodo de árbol.

imageIndex
Int32

Índice de la imagen que se va a mostrar en el nodo de árbol.

Devoluciones

Control TreeNode insertado en la colección.

Comentarios

Si la Sorted propiedad se establece trueen , se omite el valor del index parámetro. TreeNode se inserta en la vista de árbol y TreeView se vuelve a ordenar.

También puede agregar nuevos TreeNode objetos a la colección mediante los Add métodos o AddRange .

La Name propiedad corresponde a la clave de en TreeNode .TreeNodeCollection

El imageIndex parámetro hace referencia a una imagen de la ImageList propiedad del elemento primario TreeView.

Se aplica a