TreeNodeCollection.Insert Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insère un élément dans la collection à un emplacement spécifié.

Surcharges

Nom	Description
Insert(Int32, String, String, String, String)	Crée un nœud d’arborescence avec la clé, le texte et les images spécifiés, puis l’insère dans la collection à l’index spécifié.
Insert(Int32, String, String, Int32, Int32)	Crée un nœud d’arborescence avec la clé, le texte et les images spécifiés, puis l’insère dans la collection à l’index spécifié.
Insert(Int32, String, String, String)	Crée un nœud d’arborescence avec la clé, le texte et l’image spécifiés, puis l’insère dans la collection à l’index spécifié.
Insert(Int32, String, String)	Crée un nœud d’arborescence avec le texte et la clé spécifiés, puis l’insère dans la collection.
Insert(Int32, TreeNode)	Insère un nœud d’arborescence existant dans la collection de nœuds d’arborescence à l’emplacement spécifié.
Insert(Int32, String)	Crée un nœud d’arborescence avec le texte spécifié et l’insère à l’index spécifié.
Insert(Int32, String, String, Int32)	Crée un nœud d’arborescence avec la clé, le texte et l’image spécifiés, puis l’insère dans la collection à l’index spécifié.

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

Source:

TreeNodeCollection.cs

Crée un nœud d’arborescence avec la clé, le texte et les images spécifiés, puis 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);

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 pour insérer le nœud.

key

String

Nom du nœud d’arborescence.

text

String

Texte à afficher dans le nœud d’arborescence.

imageKey

String

Clé de l’image à afficher dans le nœud d’arborescence.

selectedImageKey

String

Clé de l’image à afficher dans le nœud d’arborescence lorsqu’elle est dans un état sélectionné.

Retours

TreeNode

Qui TreeNode a été inséré dans la collection.

Remarques

Si la Sorted propriété est définie truesur , la valeur du index paramètre est ignorée. L’arborescence TreeNode est insérée et triée TreeView à nouveau.

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

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.

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

Source:

TreeNodeCollection.cs

Crée un nœud d’arborescence avec la clé, le texte et les images spécifiés, puis 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);

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 pour insérer le nœud.

key

String

Nom du nœud d’arborescence.

text

String

Texte à afficher dans le nœud d’arborescence.

imageIndex

Int32

Index de l’image à afficher dans le nœud d’arborescence.

selectedImageIndex

Int32

Index de l’image à afficher dans le nœud d’arborescence lorsqu’elle est dans un état sélectionné.

Retours

TreeNode

Qui TreeNode a été inséré dans la collection.

Remarques

Si la Sorted propriété est définie truesur , la valeur du index paramètre est ignorée. L’arborescence TreeNode est insérée et triée TreeView à nouveau.

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

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.

Insert(Int32, String, String, String)

Source:

TreeNodeCollection.cs

Crée un nœud d’arborescence avec la clé, le texte et l’image spécifiés, puis 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);

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 pour insérer le nœud.

key

String

Nom du nœud d’arborescence.

text

String

Texte à afficher dans le nœud d’arborescence.

imageKey

String

Clé de l’image à afficher dans le nœud d’arborescence.

Retours

TreeNode

Qui TreeNode a été inséré dans la collection.

Remarques

Si la Sorted propriété est définie truesur , la valeur du index paramètre est ignorée. L’arborescence TreeNode est insérée et triée TreeView à nouveau.

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

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.

Insert(Int32, String, String)

Source:

TreeNodeCollection.cs

Crée un nœud d’arborescence avec le texte et la clé spécifiés, puis l’insère 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);

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 pour insérer le nœud.

key

String

Nom du nœud d’arborescence.

text

String

Texte à afficher dans le nœud d’arborescence.

Retours

TreeNode

Qui TreeNode a été inséré dans la collection.

Remarques

Si la Sorted propriété est définie truesur , la valeur du index paramètre est ignorée. L’arborescence TreeNode est insérée et triée TreeView à nouveau.

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

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

Insert(Int32, TreeNode)

Source:

TreeNodeCollection.cs

Insère un nœud d’arborescence existant dans la collection de nœuds d’arborescence à 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 pour insérer le nœud d’arborescence.

node

TreeNode

À TreeNode insérer dans la collection.

Exceptions

ArgumentException

L’objet node est actuellement affecté à un autre TreeView.

Exemples

L’exemple de code suivant supprime le nœud d’arborescence sélectionné d’un TreeView nœud et l’ajoute à un autre si les deux collections de nœuds d’arborescence ne sont pas en lecture seule. Lorsqu’un Button clic est fait, la TreeNode propriété représentée par celle-ci TreeView.SelectedNode est supprimée de l’une TreeView à l’aide de la Remove méthode et ajoutée à l’autre TreeView à l’aide de la Insert méthode. Cet exemple nécessite que vous disposiez d’un Form contrôle 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 TreeView.Sorted propriété est définie truesur , la valeur du index paramètre est ignorée. Il TreeNode est inséré dans l’arborescence, et le TreeView recours.

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

Pour supprimer un TreeNode élément que vous avez ajouté précédemment, utilisez les méthodes ou les RemoveméthodesRemoveAtClear.

Note

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

Insert(Int32, String)

Source:

TreeNodeCollection.cs

Crée un nœud d’arborescence 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);

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 pour insérer le nœud.

text

String

Texte à afficher dans le nœud d’arborescence.

Retours

TreeNode

Qui TreeNode a été inséré dans la collection.

Remarques

Si la Sorted propriété est définie truesur , la valeur du index paramètre est ignorée. L’arborescence TreeNode est insérée et triée TreeView à nouveau.

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

Insert(Int32, String, String, Int32)

Source:

TreeNodeCollection.cs

Crée un nœud d’arborescence avec la clé, le texte et l’image spécifiés, puis 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);

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 pour insérer le nœud.

key

String

Nom du nœud d’arborescence.

text

String

Texte à afficher dans le nœud d’arborescence.

imageIndex

Int32

Index de l’image à afficher dans le nœud d’arborescence.

Retours

TreeNode

Qui TreeNode a été inséré dans la collection.

Remarques

Si la Sorted propriété est définie truesur , la valeur du index paramètre est ignorée. L’arborescence TreeNode est insérée et triée TreeView à nouveau.

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

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.