TreeNodeCollection.Insert Método

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

Nome	Description
Insert(Int32, String, String, String, String)	Cria um nó de árvore com a chave, o texto e as imagens especificados e insere-o 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 insere-o 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 insere-o na coleção no índice especificado.
Insert(Int32, String, String)	Cria um nó de árvore com o texto e a chave especificados e insere-o 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 insere-o na coleção no índice especificado.

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

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

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

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 dentro da coleção para inserir o nó.

key: String

O nome do nó da árvore.

text: String

O texto a ser exibido no nó da á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ó da árvore quando ela estiver em um estado selecionado.

Retornos

TreeNode

O TreeNode que foi inserido na coleção.

Comentários

Se a Sorted propriedade estiver 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 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)

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

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

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 dentro da coleção para inserir o nó.

key: String

O nome do nó da árvore.

text: String

O texto a ser exibido no nó da á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ó da árvore quando ela estiver em um estado selecionado.

Retornos

TreeNode

O TreeNode que foi inserido na coleção.

Comentários

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)

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

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

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 dentro da coleção para inserir o nó.

key: String

O nome do nó da árvore.

text: String

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

imageKey: String

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

Retornos

TreeNode

O TreeNode que foi inserido na coleção.

Comentários

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)

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Cria um nó de árvore com o texto e a chave especificados e insere-o 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);

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 dentro da coleção para inserir o nó.

key: String

O nome do nó da árvore.

text: String

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

Retornos

TreeNode

O TreeNode que foi inserido na coleção.

Comentários

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)

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

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 dentro da coleção para inserir o nó de árvore.

node: TreeNode

A TreeNode inserção na coleção.

Exceções

ArgumentException

No node momento, a origem está atribuída 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 contenha 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 estiver definida como true, o valor do index parâmetro será ignorado. A TreeNode opção é inserida no modo de 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 os Removemétodos ou Clear . RemoveAt

Observação

Um TreeNode pode ser atribuído a apenas um TreeView controle de cada 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)

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

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

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 dentro da coleção para inserir o nó.

text: String

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

Retornos

TreeNode

O TreeNode que foi inserido na coleção.

Comentários

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)

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

Origem:: TreeNodeCollection.cs

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

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 dentro da coleção para inserir o nó.

key: String

O nome do nó da árvore.

text: String

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

imageIndex: Int32

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

Retornos

TreeNode

O TreeNode que foi inserido na coleção.

Comentários

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

Comentários

Esta página foi útil?

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

Comentários