Partager via


TreeNodeCollection.Insert Méthode

Définition

Insère un élément dans la collection au niveau de l'emplacement spécifié.

Surcharges

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

Crée un nœud d'arbre avec la clé, le texte et les image spécifiés, et l'insère dans la collection à l'index spécifié.

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

Crée un nœud d'arbre avec la clé, le texte et les image spécifiés, et l'insère dans la collection à l'index spécifié.

Insert(Int32, String, String, String)

Crée un nœud d'arbre avec la clé, le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.

Insert(Int32, String, String)

Crée un nœud d'arbre avec le texte et la clé spécifiés et indexe celui-ci dans la collection.

Insert(Int32, TreeNode)

Insère un nœud d'arbre existant dans la collection de nœuds d'arbre à l'emplacement spécifié.

Insert(Int32, String)

Crée un nœud d'arbre avec le texte spécifié et l'insère à l'index spécifié.

Insert(Int32, String, String, Int32)

Crée un nœud d'arbre avec la clé, le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.

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

Crée un nœud d'arbre avec la clé, le texte et les image spécifiés, et l'insère dans la collection à l'index spécifié.

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

index
Int32

Emplacement dans la collection où insérer le nœud.

key
String

Nom du nœud d'arbre.

text
String

Texte à afficher dans le nœud d'arbre.

imageKey
String

Clé de l'image à afficher dans le nœud d'arbre.

selectedImageKey
String

Clé de l'image à afficher dans le nœud d'arbre lorsqu'il est dans un état sélectionné.

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.

S’applique à

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

Crée un nœud d'arbre avec la clé, le texte et les image spécifiés, et l'insère dans la collection à l'index spécifié.

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

index
Int32

Emplacement dans la collection où insérer le nœud.

key
String

Nom du nœud d'arbre.

text
String

Texte à afficher dans le nœud d'arbre.

imageIndex
Int32

Index de l'image à afficher dans le nœud d'arbre.

selectedImageIndex
Int32

Index de l'image à afficher dans le nœud d'arbre lorsqu'il est dans un état sélectionné.

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.

S’applique à

Insert(Int32, String, String, String)

Crée un nœud d'arbre avec la clé, le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.

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

index
Int32

Emplacement dans la collection où insérer le nœud.

key
String

Nom du nœud d'arbre.

text
String

Texte à afficher dans le nœud d'arbre.

imageKey
String

Clé de l'image à afficher dans le nœud d'arbre.

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.

S’applique à

Insert(Int32, String, String)

Crée un nœud d'arbre avec le texte et la clé spécifiés et indexe celui-ci dans la collection.

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

index
Int32

Emplacement dans la collection où insérer le nœud.

key
String

Nom du nœud d'arbre.

text
String

Texte à afficher dans le nœud d'arbre.

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.

S’applique à

Insert(Int32, TreeNode)

Insère un nœud d'arbre existant dans la collection de nœuds d'arbre à l'emplacement spécifié.

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

index
Int32

Emplacement indexé dans la collection d'insertion du nœud d'arbre.

node
TreeNode

TreeNode à insérer dans la collection.

Exceptions

node est actuellement assigné à un autre TreeView.

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 .

Notes

Un TreeNode ne peut être affecté qu’à un TreeView seul contrôle à la fois. Pour ajouter le nœud d’arborescence à un nouveau contrôle d’arborescence, vous devez d’abord le supprimer de l’autre arborescence ou le cloner.

S’applique à

Insert(Int32, String)

Crée un nœud d'arbre avec le texte spécifié et l'insère à l'index spécifié.

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

index
Int32

Emplacement dans la collection où insérer le nœud.

text
String

Texte à afficher dans le nœud d'arbre.

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 .

S’applique à

Insert(Int32, String, String, Int32)

Crée un nœud d'arbre avec la clé, le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.

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

index
Int32

Emplacement dans la collection où insérer le nœud.

key
String

Nom du nœud d'arbre.

text
String

Texte à afficher dans le nœud d'arbre.

imageIndex
Int32

Index de l'image à afficher dans le nœud d'arbre.

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.

S’applique à