ListView.ListViewItemCollection.Insert Méthode

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string key, string text, string imageKey);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string? key, string? text, string? imageKey);

abstract member Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

Paramètres

Retours

ListViewItem ajouté à la collection.

Exceptions

Remarques

La Insert méthode définit la Name propriété de l’élément sur la clé spécifiée, afin que l’élément puisse être récupéré par son index ou par clé.

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string key, string text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string? key, string? text, int imageIndex);

abstract member Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem

Paramètres

Retours

ListViewItem ajouté à la collection.

Exceptions

Remarques

La Insert méthode définit la Name propriété de l’élément sur la clé spécifiée, afin que l’élément puisse être récupéré par son index ou par clé.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, System::String ^ imageKey);

public System.Windows.Forms.ListViewItem Insert (int index, string text, string imageKey);

public System.Windows.Forms.ListViewItem Insert (int index, string? text, string? imageKey);

member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

Paramètres

Retours

ListViewItem ajouté à la collection.

Exceptions

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::Windows::Forms::ListViewItem ^ item);

public System.Windows.Forms.ListViewItem Insert (int index, System.Windows.Forms.ListViewItem item);

member this.Insert : int * System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

Paramètres

Retours

ListViewItem inséré dans la collection.

Exceptions

Remarques

Cette version de la Insert méthode vous permet d’insérer un existant ListViewItem à une position spécifique dans le ListView.ListViewItemCollection.

Pour ajouter un élément sans spécifier de position spécifique dans la collection à ajouter à l’élément, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’éléments à la collection, utilisez la AddRange méthode . Vous pouvez utiliser cette méthode si vous souhaitez insérer un nouvel élément dans une collection d’éléments existante.

Voir aussi

• Add(String)
• AddRange(ListViewItem[])

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);

public System.Windows.Forms.ListViewItem Insert (int index, string text);

public System.Windows.Forms.ListViewItem Insert (int index, string? text);

member this.Insert : int * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String) As ListViewItem

Paramètres

Retours

ListViewItem inséré dans la collection.

Exceptions

Remarques

Cette version de la Insert méthode vous permet d’insérer un nouvel élément à une position spécifique dans le ListView.ListViewItemCollection. Le texte spécifié dans le text paramètre est utilisé pour créer un nouveau ListViewItem qui est ensuite inséré dans le ListView.ListViewItemCollection à l’emplacement spécifié.

Pour ajouter un élément sans spécifier de position spécifique dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’éléments à la collection, utilisez la AddRange méthode . Vous pouvez utiliser cette méthode si vous souhaitez insérer un nouvel élément dans une collection d’éléments existante.

Voir aussi

• Add(String)
• AddRange(ListViewItem[])

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert (int index, string text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert (int index, string? text, int imageIndex);

member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

Paramètres

Retours

ListViewItem inséré dans la collection.

Exceptions

Remarques

Cette version de la Insert méthode vous permet d’insérer un nouvel élément à une position spécifique dans le ListView.ListViewItemCollection. Le texte spécifié dans le text paramètre est utilisé pour créer un nouveau ListViewItem qui est ensuite inséré dans le ListView.ListViewItemCollection à l’emplacement spécifié.

Vous pouvez également utiliser cette version de la Insert méthode pour spécifier une image pour l’élément en passant l’index du ImageList affecté aux ListView.LargeImageList propriétés et ListView.SmallImageList au imageIndex paramètre . (En règle générale, les ListView.LargeImageList propriétés et ListView.SmallImageList utilisent les mêmes positions d’index pour afficher les images associées.) Si vous ne souhaitez pas spécifier d’index d’image pour l’élément, utilisez l’autre version de la Insert méthode qui accepte une chaîne comme paramètre.

Pour ajouter un élément sans spécifier de position spécifique dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’éléments à la collection, utilisez la AddRange méthode .

Voir aussi

• Add(String)
• AddRange(ListViewItem[])