Partilhar via


TreeNodeCollection.Insert Método

Definição

Insere um item na coleção em um local especificado.

Sobrecargas

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

Cria um nó de árvore com a chave, o texto e as imagens especificados e os insere na coleção no índice especificado.

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

Cria um nó de árvore com a chave, o texto e as imagens especificados e os insere na coleção no índice especificado.

Insert(Int32, String, String, String)

Cria um nó de árvore com a chave, o texto e a imagem especificados e o insere na coleção no índice especificado.

Insert(Int32, String, String)

Cria um nó de árvore com a chave e o texto especificados e o insere na coleção.

Insert(Int32, TreeNode)

Insere um nó de árvore existente na coleção de nós de árvore no local especificado.

Insert(Int32, String)

Cria um nó de árvore com o texto especificado e o insere no índice especificado.

Insert(Int32, String, String, Int32)

Cria um nó de árvore com a chave, o texto e a imagem especificados e o insere na coleção no índice especificado.

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

Cria um nó de árvore com a chave, o texto e as imagens especificados e os insere na coleção no í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);
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

O local na coleção no qual inserir o nó.

key
String

O nome do nó de árvore.

text
String

O texto a ser exibido no nó de árvore.

imageKey
String

A chave da imagem a ser exibida no nó da árvore.

selectedImageKey
String

A chave da imagem a ser exibida no nó de árvore quando ele está em um estado selecionado.

Retornos

TreeNode

O TreeNode inserido na coleção.

Comentários

Se a Sorted propriedade for definida como true, o valor do index parâmetro será ignorado. Ela TreeNode é inserida no modo de exibição de árvore e é TreeView classificada novamente.

Você também pode adicionar novos TreeNode objetos à coleção usando os métodos ou AddRange os Add métodos.

A Name propriedade corresponde à chave de um TreeNode no TreeNodeCollection.

O imageKey parâmetro refere-se a uma imagem na ImageList propriedade do pai TreeView.

O selectedimageKey parâmetro refere-se a uma imagem na StateImageList propriedade do pai TreeView.

Aplica-se a

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

Cria um nó de árvore com a chave, o texto e as imagens especificados e os insere na coleção no í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);
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

O local na coleção no qual inserir o nó.

key
String

O nome do nó de árvore.

text
String

O texto a ser exibido no nó de árvore.

imageIndex
Int32

O índice da imagem a ser exibida no nó da árvore.

selectedImageIndex
Int32

O índice da imagem a ser exibida no nó de árvore quando ele está em um estado selecionado.

Retornos

TreeNode

O TreeNode inserido na coleção.

Comentários

Se a Sorted propriedade for definida como true, o valor do index parâmetro será ignorado. Ela TreeNode é inserida no modo de exibição de árvore e é TreeView classificada novamente.

Você também pode adicionar novos TreeNode objetos à coleção usando os métodos ou AddRange os Add métodos.

A Name propriedade corresponde à chave de um TreeNode no TreeNodeCollection.

O imageIndex parâmetro refere-se a uma imagem na ImageList propriedade do pai TreeView.

O selectedimageIndex parâmetro refere-se a uma imagem na StateImageList propriedade do pai TreeView.

Aplica-se a

Insert(Int32, String, String, String)

Cria um nó de árvore com a chave, o texto e a imagem especificados e o insere na coleção no í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);
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

O local na coleção no qual inserir o nó.

key
String

O nome do nó de árvore.

text
String

O texto a ser exibido no nó de árvore.

imageKey
String

A chave da imagem a ser exibida no nó da árvore.

Retornos

TreeNode

O TreeNode inserido na coleção.

Comentários

Se a Sorted propriedade for definida como true, o valor do index parâmetro será ignorado. Ela TreeNode é inserida no modo de exibição de árvore e é TreeView classificada novamente.

Você também pode adicionar novos TreeNode objetos à coleção usando os métodos ou AddRange os Add métodos.

A Name propriedade corresponde à chave de um TreeNode no TreeNodeCollection.

O imageKey parâmetro refere-se a uma imagem na ImageList propriedade do pai TreeView.

Aplica-se a

Insert(Int32, String, String)

Cria um nó de árvore com a chave e o texto especificados e o insere na coleção.

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

Parâmetros

index
Int32

O local na coleção no qual inserir o nó.

key
String

O nome do nó de árvore.

text
String

O texto a ser exibido no nó de árvore.

Retornos

TreeNode

O TreeNode inserido na coleção.

Comentários

Se a Sorted propriedade for definida como true, o valor do index parâmetro será ignorado. A TreeNode opção é inserida no modo de exibição de árvore e é TreeView classificada novamente.

Você também pode adicionar novos TreeNode objetos à coleção usando os métodos ou AddRange os Add métodos.

A Name propriedade corresponde à chave de um TreeNode no TreeNodeCollection.

Aplica-se a

Insert(Int32, TreeNode)

Insere um nó de árvore existente na coleção de nós de árvore no local especificado.

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

O local indexado na coleção para inserir o nó de árvore.

node
TreeNode

O TreeNode a ser inserido na coleção.

Exceções

O node está atualmente atribuído a outra TreeView.

Exemplos

O exemplo de código a seguir remove o nó de árvore selecionado de um TreeView e o adiciona a outro se ambas as coleções de nós de árvore não forem somente leitura. Quando um Button é clicado, o TreeNode representado pela TreeView.SelectedNode propriedade é excluído de um TreeView usando o Remove método e adicionado ao outro TreeView usando o Insert método. Este exemplo requer que você tenha um Form que contém dois TreeView controles e um Button. Os TreeView controles devem ser nomeados treeView1 e 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

Comentários

Se a TreeView.Sorted propriedade for definida como true, o valor do index parâmetro será ignorado. A TreeNode opção é inserida na exibição de árvore e recorrida TreeView .

Você também pode adicionar novos TreeNode objetos à coleção usando os métodos ou AddRange os Add métodos.

Para remover um TreeNode que você adicionou anteriormente, use o Remove, RemoveAtou Clear métodos.

Observação

Uma TreeNode pode ser atribuída a apenas um TreeView controle por vez. Para adicionar o nó de árvore a um novo controle de exibição de árvore, você deve removê-lo da outra exibição de árvore primeiro ou cloná-lo.

Aplica-se a

Insert(Int32, String)

Cria um nó de árvore com o texto especificado e o insere no í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);
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

O local na coleção no qual inserir o nó.

text
String

O texto a ser exibido no nó de árvore.

Retornos

TreeNode

O TreeNode inserido na coleção.

Comentários

Se a Sorted propriedade for definida como true, o valor do index parâmetro será ignorado. A TreeNode opção é inserida no modo de exibição de árvore e é TreeView classificada novamente.

Você também pode adicionar novos TreeNode objetos à coleção usando os métodos ou AddRange os Add métodos.

Aplica-se a

Insert(Int32, String, String, Int32)

Cria um nó de árvore com a chave, o texto e a imagem especificados e o insere na coleção no í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);
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

O local na coleção no qual inserir o nó.

key
String

O nome do nó de árvore.

text
String

O texto a ser exibido no nó de árvore.

imageIndex
Int32

O índice da imagem a ser exibida no nó da árvore.

Retornos

TreeNode

O TreeNode inserido na coleção.

Comentários

Se a Sorted propriedade for definida como true, o valor do index parâmetro será ignorado. A TreeNode opção é inserida no modo de exibição de árvore e é TreeView classificada novamente.

Você também pode adicionar novos TreeNode objetos à coleção usando os métodos ou AddRange os Add métodos.

A Name propriedade corresponde à chave de um TreeNode no TreeNodeCollection.

O imageIndex parâmetro refere-se a uma imagem na ImageList propriedade do pai TreeView.

Aplica-se a