TreeNodeCollection.Insert Método

Definição

Espaço de Nomes:: System.Windows.Forms

Assemblagem:: System.Windows.Forms.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

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

A localização dentro da coleção para inserir o nó.

key: String

O nome do nó árvore.

text: String

O texto para mostrar no nó da árvore.

imageKey: String

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

selectedImageKey: String

A chave da imagem deve ser exibida no nó da árvore quando está num estado selecionado.

Devoluções

TreeNode

Isso TreeNode foi inserido na coleção.

Observações

Se a Sorted propriedade for definida para true, o index valor do parâmetro é ignorado. O TreeNode é inserido na vista em árvore e é TreeView ordenado novamente.

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

A Name propriedade corresponde à chave para 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, texto e 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

A localização dentro da coleção para inserir o nó.

key: String

O nome do nó árvore.

text: String

O texto para mostrar no nó da árvore.

imageIndex: Int32

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

selectedImageIndex: Int32

O índice da imagem a mostrar no nó da árvore quando estiver num estado selecionado.

Devoluções

TreeNode

Isso TreeNode foi inserido na coleção.

Observações

Se a Sorted propriedade for definida para true, o index valor do parâmetro é ignorado. O TreeNode é inserido na vista em árvore e é TreeView ordenado novamente.

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

A Name propriedade corresponde à chave para 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, texto e 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

A localização dentro da coleção para inserir o nó.

key: String

O nome do nó árvore.

text: String

O texto para mostrar no nó da árvore.

imageKey: String

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

Devoluções

TreeNode

Isso TreeNode foi inserido na coleção.

Observações

Se a Sorted propriedade for definida para true, o index valor do parâmetro é ignorado. O TreeNode é inserido na vista em árvore e é TreeView ordenado novamente.

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

A Name propriedade corresponde à chave para 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-os 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

A localização dentro da coleção para inserir o nó.

key: String

O nome do nó árvore.

text: String

O texto para mostrar no nó da árvore.

Devoluções

TreeNode

Isso TreeNode foi inserido na coleção.

Observações

Se a Sorted propriedade for definida para true, o index valor do parâmetro é ignorado. O TreeNode é inserido na vista em árvore e é TreeView ordenado novamente.

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

A Name propriedade corresponde à chave para 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

A localização indexada dentro da coleção para inserir o nó da árvore.

node: TreeNode

O TreeNode para inserir na coleção.

Exceções

ArgumentException

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

Exemplos

O exemplo de código seguinte remove o nó de árvore selecionado de um TreeView e adiciona-o a outro se ambas as coleções de nós de árvore não forem apenas de leitura. Quando se clica em a Button , a TreeNode propriedade representada TreeView.SelectedNode pela propriedade é eliminada de um TreeView usando o Remove método e adicionado ao outro TreeView usando o Insert método. Este exemplo exige que tenhas um Form que contenha dois TreeView controlos e um Button. Os TreeView controlos 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

Observações

Se a TreeView.Sorted propriedade for definida para true, o index valor do parâmetro é ignorado. O TreeNode é inserido na vista da árvore, e o TreeView resorted.

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

Para remover um TreeNode que adicionou anteriormente, use os Removemétodos , RemoveAt, ou Clear .

Note

A TreeNode pode ser atribuído a apenas um TreeView controlo de cada vez. Para adicionar o nó de árvore a um novo controlo de vista de árvore, deve removê-lo primeiro da outra vista de árvore 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ó em árvore com o texto especificado e insere-o 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

A localização dentro da coleção para inserir o nó.

text: String

O texto para mostrar no nó da árvore.

Devoluções

TreeNode

Isso TreeNode foi inserido na coleção.

Observações

Se a Sorted propriedade for definida para true, o index valor do parâmetro é ignorado. O TreeNode é inserido na vista em árvore e é TreeView ordenado novamente.

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

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, texto e 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

A localização dentro da coleção para inserir o nó.

key: String

O nome do nó árvore.

text: String

O texto para mostrar no nó da árvore.

imageIndex: Int32

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

Devoluções

TreeNode

Isso TreeNode foi inserido na coleção.

Observações

Se a Sorted propriedade for definida para true, o index valor do parâmetro é ignorado. O TreeNode é inserido na vista em árvore e é TreeView ordenado novamente.

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

A Name propriedade corresponde à chave para 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?