ListView.ListViewItemCollection.Add Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ajoute un élément à la collection d’éléments.

Surcharges

Nom	Description
Add(String)	Crée un élément avec le texte spécifié et l’ajoute à la collection.
Add(ListViewItem)	Ajoute un élément existant ListViewItem à 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)

Source:

ListView.ListViewItemCollection.cs

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);

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

Qui ListViewItem a été ajouté à la collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour créer une nouvelle ListViewItem version à 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 en tant que paramètre. Si vous disposez d’un élément existant ListViewItem que vous souhaitez ajouter à la collection, utilisez la version de la Add méthode qui accepte un ListViewItem tel paramètre.

Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la propriété est définie, la ListViewItemSorter 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 une ListView position spécifique. Pour ajouter un ensemble d’éléments au contrôle dans 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 les BeginUpdate méthodes pour empêcher la ListView 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 les éléments en premier, puis d’ajouter de nouveaux éléments.

Voir aussi

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

Add(ListViewItem)

Source:

ListView.ListViewItemCollection.cs

Ajoute un élément existant ListViewItem à 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

À ListViewItem ajouter à la collection.

Retours

ListViewItem

Qui ListViewItem a été ajouté à la collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour ajouter une version existante ListViewItem à la collection. Cette version de la Add méthode est généralement utilisée pour réutiliser des éléments à partir d’autres ListView contrôles ou si celle-ci ListViewItem a été créée manuellement avant de l’ajouter à la collection. Si vous souhaitez créer un élément 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 propriété est définie, la ListViewItemSorter 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 une ListView position spécifique. Pour ajouter un ensemble d’éléments au contrôle dans 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 les BeginUpdate méthodes pour empêcher la ListView 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 les éléments en premier, 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

Add(String, Int32)

Source:

ListView.ListViewItemCollection.cs

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);

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

Texte de l’élément.

imageIndex

Int32

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

Retours

ListViewItem

Qui ListViewItem a été ajouté à la collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour créer une nouvelle ListViewItem version à 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 transmettant l’index de l’objet ImageList affecté aux propriétés imageIndex et ListView.SmallImageList au ListView.LargeImageList paramètre. (En règle générale, les ListView.LargeImageList propriétés 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 en tant que paramètre. Si vous disposez d’un élément existant ListViewItem que vous souhaitez ajouter à la collection, utilisez la version de la Add méthode qui accepte un ListViewItem tel paramètre.

Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la propriété est définie, la ListViewItemSorter 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 une ListView position spécifique. Pour ajouter un ensemble d’éléments au contrôle dans 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 les BeginUpdate méthodes pour empêcher la ListView 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 les éléments en premier, puis d’ajouter de nouveaux éléments.

Voir aussi

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

Add(String, String)

Source:

ListView.ListViewItemCollection.cs

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);

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

Texte de l’élément.

imageKey

String

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

Retours

ListViewItem

Ajouté ListViewItem à la collection.

Remarques

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

Add(String, String, Int32)

Source:

ListView.ListViewItemCollection.cs

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);

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

Texte de l’élément.

imageIndex

Int32

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

Retours

ListViewItem

Ajouté ListViewItem à la collection.

Exceptions

InvalidOperationException

Le conteneur ListView est en mode virtuel.

Remarques

Si la ListView valeur est triée, 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é.

Add(String, String, String)

Source:

ListView.ListViewItemCollection.cs

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);

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

Texte de l’élément.

imageKey

String

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

Retours

ListViewItem

Ajouté ListViewItem à la collection.

Remarques

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

Si la ListView valeur est triée, 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, afin que l’élément puisse être récupéré par son index ou par clé.