Partager via


ListView.ListViewItemCollection.Add Méthode

Définition

Ajoute un élément à la collection.

Surcharges

Add(String)

Crée un élément avec le texte spécifié et l'ajoute à la collection.

Add(ListViewItem)

Ajoute un ListViewItem existant à la collection.

Add(String, Int32)

Crée un élément avec le texte et l'image spécifiés et l'ajoute à la collection.

Add(String, String)

Crée un élément avec le texte et l'image spécifiés et l'ajoute à la collection.

Add(String, String, Int32)

Crée un élément avec la clé, le texte et l'image spécifiés et ajoute un élément à la collection.

Add(String, String, String)

Crée un élément avec la clé, le texte et l'image spécifiés et l'ajoute à la collection.

Add(String)

Crée un élément avec le texte spécifié et l'ajoute à la collection.

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

text
String

Texte à afficher pour l'élément.

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

S’applique à

Add(ListViewItem)

Ajoute un ListViewItem existant à la collection.

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

value
ListViewItem

Objet ListViewItem à ajouter à la collection.

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

S’applique à

Add(String, Int32)

Crée un élément avec le texte et l'image spécifiés et l'ajoute à la collection.

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

text
String

Le texte de l'élément.

imageIndex
Int32

Index de l'image à afficher pour l'élément.

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

S’applique à

Add(String, String)

Crée un élément avec le texte et l'image spécifiés et l'ajoute à la collection.

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

text
String

Le texte de l'élément.

imageKey
String

Clé de l'image à afficher pour l'élément.

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.

S’applique à

Add(String, String, Int32)

Crée un élément avec la clé, le texte et l'image spécifiés et ajoute un élément à 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

key
String

Nom de l'élément.

text
String

Le texte de l'élément.

imageIndex
Int32

Index de l'image à afficher pour l'élément.

Retours

ListViewItem ajouté à la collection.

Exceptions

Le ListView conteneur est en mode virtuel.

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é.

S’applique à

Add(String, String, String)

Crée un élément avec la clé, le texte et l'image spécifiés et l'ajoute à la collection.

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

key
String

Nom de l'élément.

text
String

Le texte de l'élément.

imageKey
String

Clé de l'image à afficher pour l'élément.

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é.

S’applique à