TreeNodeCollection.Insert Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

ArgumentException

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

Partilhar via

TreeNodeCollection.Insert Método

Definição

Sobrecargas

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

Parâmetros

Retornos

Comentários

Aplica-se a

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

Parâmetros

Retornos

Comentários

Aplica-se a

Insert(Int32, String, String, String)

Parâmetros

Retornos

Comentários

Aplica-se a

Insert(Int32, String, String)

Parâmetros

Retornos

Comentários

Aplica-se a

Insert(Int32, TreeNode)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Insert(Int32, String)

Parâmetros

Retornos

Comentários

Aplica-se a

Insert(Int32, String, String, Int32)

Parâmetros

Retornos

Comentários

Aplica-se a

Recursos adicionais