ListView.ListViewItemCollection.Add Méthode

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ListViewItem Add (string text);

public virtual System.Windows.Forms.ListViewItem Add (string? text);

abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String) As ListViewItem

Paramètres

Retours

ListViewItem ajouté à la collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour créer un nouveau ListViewItem à ajouter à un ListView contrôle. Le texte du nouveau ListViewItem ajouté au contrôle est basé sur le text paramètre . Si vous souhaitez spécifier une image pour l’élément, utilisez la version de la Add méthode qui accepte un index d’image comme paramètre. Si vous souhaitez ajouter un élément existant ListViewItem à la collection, utilisez la version de la Add méthode qui accepte un ListViewItem comme paramètre.

Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la ListViewItemSorter propriété est définie, la liste est triée après l’ajout de l’élément. Sinon, l’élément est inséré à la fin de la liste. Si la liste n’est pas triée, vous pouvez utiliser la Insert méthode pour insérer un élément dans le ListView à une position spécifique. Pour ajouter un ensemble d’éléments au contrôle en une seule opération, utilisez la AddRange méthode . Si vous souhaitez utiliser la Add méthode pour ajouter un grand nombre d’éléments au contrôle, utilisez les méthodes et EndUpdate pour empêcher le ListViewBeginUpdate de repeindre jusqu’à ce que tous les éléments soient ajoutés. Lors de l’ajout d’éléments à un ListView, il est plus efficace de trier d’abord les éléments, puis d’ajouter de nouveaux éléments.

Voir aussi

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);

public virtual System.Windows.Forms.ListViewItem Add (System.Windows.Forms.ListViewItem value);

abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (value As ListViewItem) As ListViewItem

Paramètres

Retours

ListViewItem ajouté à la collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour ajouter un existant ListViewItem à la collection. Cette version de la Add méthode est généralement utilisée pour réutiliser des éléments d’autres ListView contrôles ou si le a été créé manuellement avant de ListViewItem l’ajouter à la collection. Si vous souhaitez créer un nouveau ListViewItem au lieu d’utiliser un élément existant, utilisez les autres versions de la Add méthode.

Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la ListViewItemSorter propriété est définie, la liste est triée après l’ajout de l’élément. Sinon, l’élément est inséré à la fin de la liste. Si la liste n’est pas triée, vous pouvez utiliser la Insert méthode pour insérer un élément dans le ListView à une position spécifique. Pour ajouter un ensemble d’éléments au contrôle en une seule opération, utilisez la AddRange méthode . Si vous souhaitez utiliser la Add méthode pour ajouter un grand nombre d’éléments au contrôle, utilisez les méthodes et EndUpdate pour empêcher le ListViewBeginUpdate de repeindre jusqu’à ce que tous les éléments soient ajoutés. Lors de l’ajout d’éléments à un ListView, il est plus efficace de trier d’abord les éléments, puis d’ajouter de nouveaux éléments.

Cette version de la Add méthode est également utilisée pour affecter un ListViewItem à un ListViewGroup.

Voir aussi

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

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

public virtual System.Windows.Forms.ListViewItem Add (string text, int imageIndex);

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

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

Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

Paramètres

Retours

ListViewItem ajouté à la collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour créer un nouveau ListViewItem à ajouter au ListView contrôle. Le texte du nouveau ListViewItem ajouté au contrôle est basé sur le text paramètre . Vous pouvez également 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 la version de la Add méthode qui accepte uniquement une chaîne comme paramètre. Si vous souhaitez ajouter un élément existant ListViewItem à la collection, utilisez la version de la Add méthode qui accepte un ListViewItem comme paramètre.

Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la ListViewItemSorter propriété est définie, la liste est triée après l’ajout de l’élément. Sinon, l’élément est inséré à la fin de la liste. Si la liste n’est pas triée, vous pouvez utiliser la Insert méthode pour insérer un élément dans le ListView à une position spécifique. Pour ajouter un ensemble d’éléments au contrôle en une seule opération, utilisez la AddRange méthode . Si vous souhaitez utiliser la Add méthode pour ajouter un grand nombre d’éléments au contrôle, utilisez les méthodes et EndUpdate pour empêcher le ListViewBeginUpdate de repeindre jusqu’à ce que tous les éléments soient ajoutés. Lors de l’ajout d’éléments à un ListView, il est plus efficace de trier d’abord les éléments, puis d’ajouter de nouveaux éléments.

Voir aussi

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add (string text, string imageKey);

public virtual System.Windows.Forms.ListViewItem Add (string? text, string? imageKey);

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

Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

Paramètres

Retours

ListViewItem ajouté à la collection.

Remarques

Si le ListView est trié, l’élément est ajouté dans l’ordre correctement trié ; sinon, il est ajouté à la fin de la collection.

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

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

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

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

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

Paramètres

Retours

ListViewItem ajouté à la collection.

Exceptions

Remarques

Si le ListView est trié, l’élément est ajouté dans l’ordre correctement trié ; sinon, il est ajouté à la fin de la collection. La Name propriété correspond à la clé d’un ListViewItem dans le ListView.ListViewItemCollection.

La Add méthode définit la Name propriété 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 ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add (string key, string text, string imageKey);

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

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

Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

Paramètres

Retours

ListViewItem ajouté à la collection.

Remarques

La Name propriété correspond à la clé d’un ListViewItem dans le ListView.ListViewItemCollection.

Si le ListView est trié, l’élément est ajouté dans l’ordre correctement trié ; sinon, il est ajouté à la fin de la collection. La Add méthode définit la Name propriété de l’élément sur la clé spécifiée, de sorte que l’élément peut être récupéré par son index ou par clé.