TreeNodeCollection.Insert Méthode

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

Paramètres

Retours

TreeNode inséré dans la collection.

Remarques

Si la propriété a la Sortedtruevaleur , la valeur du index paramètre est ignorée. le TreeNode est inséré dans l’arborescence et le TreeView est trié à nouveau.

Vous pouvez également ajouter de nouveaux TreeNode objets à la collection à l’aide des Add méthodes ou AddRange .

La Name propriété correspond à la clé d’un TreeNode dans le TreeNodeCollection.

Le imageKey paramètre fait référence à une image dans la ImageList propriété du parent TreeView.

Le selectedimageKey paramètre fait référence à une image dans la StateImageList propriété du parent TreeView.

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

Paramètres

Retours

TreeNode inséré dans la collection.

Remarques

Si la propriété a la Sortedtruevaleur , la valeur du index paramètre est ignorée. le TreeNode est inséré dans l’arborescence et le TreeView est trié à nouveau.

Vous pouvez également ajouter de nouveaux TreeNode objets à la collection à l’aide des Add méthodes ou AddRange .

La Name propriété correspond à la clé d’un TreeNode dans le TreeNodeCollection.

Le imageIndex paramètre fait référence à une image dans la ImageList propriété du parent TreeView.

Le selectedimageIndex paramètre fait référence à une image dans la StateImageList propriété du parent TreeView.

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

Paramètres

Retours

TreeNode inséré dans la collection.

Remarques

Si la propriété a la Sortedtruevaleur , la valeur du index paramètre est ignorée. le TreeNode est inséré dans l’arborescence et le TreeView est trié à nouveau.

Vous pouvez également ajouter de nouveaux TreeNode objets à la collection à l’aide des Add méthodes ou AddRange .

La Name propriété correspond à la clé d’un TreeNode dans le TreeNodeCollection.

Le imageKey paramètre fait référence à une image dans la ImageList propriété du parent TreeView.

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

Paramètres

Retours

TreeNode inséré dans la collection.

Remarques

Si la propriété a la Sortedtruevaleur , la valeur du index paramètre est ignorée. le TreeNode est inséré dans l’arborescence et le TreeView est trié à nouveau.

Vous pouvez également ajouter de nouveaux TreeNode objets à la collection à l’aide des Add méthodes ou AddRange .

La Name propriété correspond à la clé d’un TreeNode dans le TreeNodeCollection.

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)

Paramètres

Exceptions

Exemples

L’exemple de code suivant supprime le nœud d’arborescence sélectionné de l’un d’eux TreeView et l’ajoute à un autre si les deux collections de nœuds d’arborescence ne sont pas en lecture seule. Lorsque vous cliquez sur un Button , le TreeNode représenté par la propriété est supprimé de l’une TreeView.SelectedNode à l’aide TreeView de la Remove méthode et ajouté à l’autre TreeView à l’aide de la Insert méthode . Cet exemple nécessite que vous ayez un Form qui contient deux TreeView contrôles et un Button. Les TreeView contrôles doivent être nommés treeView1 et 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

Remarques

Si la propriété a la TreeView.Sortedtruevaleur , la valeur du index paramètre est ignorée. Le TreeNode est inséré dans la vue d’arbre, et le TreeView resorted.

Vous pouvez également ajouter de nouveaux TreeNode objets à la collection à l’aide des Add méthodes ou AddRange .

Pour supprimer un TreeNode que vous avez ajouté précédemment, utilisez les Removeméthodes , RemoveAtou Clear .

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

Paramètres

Retours

TreeNode inséré dans la collection.

Remarques

Si la propriété a la Sortedtruevaleur , la valeur du index paramètre est ignorée. le TreeNode est inséré dans l’arborescence et le TreeView est trié à nouveau.

Vous pouvez également ajouter de nouveaux TreeNode objets à la collection à l’aide des Add méthodes ou AddRange .

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

Paramètres

Retours

TreeNode inséré dans la collection.

Remarques

Si la propriété a la Sortedtruevaleur , la valeur du index paramètre est ignorée. le TreeNode est inséré dans l’arborescence et le TreeView est trié à nouveau.

Vous pouvez également ajouter de nouveaux TreeNode objets à la collection à l’aide des Add méthodes ou AddRange .

La Name propriété correspond à la clé d’un TreeNode dans le TreeNodeCollection.

Le imageIndex paramètre fait référence à une image dans la ImageList propriété du parent TreeView.