ListView.ListViewItemCollection.Add ListView.ListViewItemCollection.Add ListView.ListViewItemCollection.Add ListView.ListViewItemCollection.Add Method

Définition

Ajoute un élément à la collection.Adds an item to the collection of items.

Surcharges

Add(String) Add(String) Add(String) Add(String)

Crée un élément avec le texte spécifié et l'ajoute à la collection.Creates an item with the specified text and adds it to the collection.

Add(ListViewItem) Add(ListViewItem) Add(ListViewItem) Add(ListViewItem)

Ajoute un ListViewItem existant à la collection.Adds an existing ListViewItem to the collection.

Add(String, Int32) Add(String, Int32) Add(String, Int32) Add(String, Int32)

Crée un élément avec le texte et l'image spécifiés et l'ajoute à la collection.Creates an item with the specified text and image and adds it to the collection.

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Crée un élément avec le texte et l'image spécifiés et l'ajoute à la collection.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32) Add(String, String, Int32) Add(String, String, Int32) 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.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String) Add(String, String, String) Add(String, String, String) 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.Creates an item with the specified key, text, and image, and adds it to the collection.

Add(String) Add(String) Add(String) Add(String)

Crée un élément avec le texte spécifié et l'ajoute à la collection.Creates an item with the specified text and adds it to the 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 String String String

Texte à afficher pour l'élément.The text to display for the item.

Retours

ListViewItem ajouté à la collection.The ListViewItem that was added to the collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour créer ListViewItem un à ajouter à un ListView contrôle.You can use this version of the Add method to create a new ListViewItem to add to a ListView control. Le texte du nouveau ListViewItem ajouté au contrôle est basé sur le text paramètre.The text of the new ListViewItem added to the control is based on the text parameter. Si vous souhaitez spécifier une image pour l’élément, utilisez la version de la Add méthode qui accepte un index d’images en tant que paramètre.If you want to specify an image for the item, use the version of the Add method that accepts an image index as a parameter. Si vous avez un existant ListViewItem que vous souhaitez ajouter à la collection, utilisez la version de la Add méthode qui accepte un ListViewItem comme paramètre.If you have an existing ListViewItem that you want to add to the collection, use the version of the Add method that accepts a ListViewItem as its parameter.

SortOrder.None ListViewItemSorter Si la ListView.Sorting propriété est définie sur une valeur autre que ou si la propriété est définie, la liste est triée après l’ajout de l’élément.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. Dans le cas contraire, l’élément est inséré à la fin de la liste.Otherwise, the item is inserted at the end of the list. Si la liste n’est pas triée, vous pouvez Insert utiliser la méthode pour insérer un élément ListView dans à une position spécifique.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Pour ajouter un ensemble d’éléments au contrôle en une seule opération, utilisez la AddRange méthode.To add a set of items to the control in a single operation, use the AddRange method. Si vous souhaitez utiliser Add la méthode pour ajouter un grand nombre d’éléments au contrôle, utilisez les BeginUpdate méthodes et EndUpdate pour empêcher le ListView de se redessiner jusqu’à ce que tous les éléments soient ajoutés.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. Lors de l’ajout d' ListViewéléments à un, il est plus efficace de trier d’abord les éléments, puis d’ajouter de nouveaux éléments.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Voir aussi

Add(ListViewItem) Add(ListViewItem) Add(ListViewItem) Add(ListViewItem)

Ajoute un ListViewItem existant à la collection.Adds an existing ListViewItem to the 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 ListViewItem ListViewItem

Objet ListViewItem à ajouter à la collection.The ListViewItem to add to the collection.

Retours

ListViewItem ajouté à la collection.The ListViewItem that was added to the collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour ajouter un existant ListViewItem à la collection.You can use this version of the Add method to add an existing ListViewItem to the collection. Cette version de la Add méthode est généralement utilisée pour réutiliser des éléments ListView d’autres contrôles ou ListViewItem si le a été créé manuellement avant d’être ajouté à la collection.This version of the Add method is typically used to reuse items from other ListView controls or if the ListViewItem was created manually before adding it to the 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.If you want to create a new ListViewItem instead of using an existing item, use the other versions of the Add method.

SortOrder.None ListViewItemSorter Si la ListView.Sorting propriété est définie sur une valeur autre que ou si la propriété est définie, la liste est triée après l’ajout de l’élément.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. Dans le cas contraire, l’élément est inséré à la fin de la liste.Otherwise, the item is inserted at the end of the list. Si la liste n’est pas triée, vous pouvez Insert utiliser la méthode pour insérer un élément ListView dans à une position spécifique.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Pour ajouter un ensemble d’éléments au contrôle en une seule opération, utilisez la AddRange méthode.To add a set of items to the control in a single operation, use the AddRange method. Si vous souhaitez utiliser Add la méthode pour ajouter un grand nombre d’éléments au contrôle, utilisez les BeginUpdate méthodes et EndUpdate pour empêcher le ListView de se redessiner jusqu’à ce que tous les éléments soient ajoutés.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. Lors de l’ajout d' ListViewéléments à un, il est plus efficace de trier d’abord les éléments, puis d’ajouter de nouveaux éléments.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Cette version de la Add méthode est également utilisée pour assigner un ListViewGroup ListViewItem à un.This version of the Add method is also used to assign a ListViewItem to a ListViewGroup.

Voir aussi

Add(String, Int32) Add(String, Int32) Add(String, Int32) Add(String, Int32)

Crée un élément avec le texte et l'image spécifiés et l'ajoute à la collection.Creates an item with the specified text and image and adds it to the 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 String String String

Le texte de l'élément.The text of the item.

imageIndex
Int32 Int32 Int32 Int32

Index de l'image à afficher pour l'élément.The index of the image to display for the item.

Retours

ListViewItem ajouté à la collection.The ListViewItem that was added to the collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour créer ListViewItem un à ajouter au ListView contrôle.You can use this version of the Add method to create a new ListViewItem to add to the ListView control. Le texte du nouveau ListViewItem ajouté au contrôle est basé sur le text paramètre.The text of the new ListViewItem added to the control is based on the text parameter. Vous pouvez également spécifier une image pour l’élément en passant l’index ImageList du affecté ListView.LargeImageList aux propriétés et ListView.SmallImageList au imageIndex paramètre.You can also specify an image for the item by passing the index of the ImageList assigned to the ListView.LargeImageList and ListView.SmallImageList properties to the imageIndex parameter. (En général, ListView.LargeImageList les ListView.SmallImageList propriétés et 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.(Typically, the ListView.LargeImageList and ListView.SmallImageList properties use the same index positions to display related images.) If you do not want to specify an image index for the item, use the version of the Add method that accepts only a string as a parameter. Si vous avez un existant ListViewItem que vous souhaitez ajouter à la collection, utilisez la version de la Add méthode qui accepte un ListViewItem comme paramètre.If you have an existing ListViewItem that you want to add to the collection, use the version of the Add method that accepts a ListViewItem as its parameter.

SortOrder.None ListViewItemSorter Si la ListView.Sorting propriété est définie sur une valeur autre que ou si la propriété est définie, la liste est triée après l’ajout de l’élément.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. Dans le cas contraire, l’élément est inséré à la fin de la liste.Otherwise, the item is inserted at the end of the list. Si la liste n’est pas triée, vous pouvez Insert utiliser la méthode pour insérer un élément ListView dans à une position spécifique.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Pour ajouter un ensemble d’éléments au contrôle en une seule opération, utilisez la AddRange méthode.To add a set of items to the control in a single operation, use the AddRange method. Si vous souhaitez utiliser Add la méthode pour ajouter un grand nombre d’éléments au contrôle, utilisez les BeginUpdate méthodes et EndUpdate pour empêcher le ListView de se redessiner jusqu’à ce que tous les éléments soient ajoutés.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. Lors de l’ajout d' ListViewéléments à un, il est plus efficace de trier d’abord les éléments, puis d’ajouter de nouveaux éléments.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Voir aussi

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Crée un élément avec le texte et l'image spécifiés et l'ajoute à la collection.Creates an item with the specified text and image and adds it to the 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 String String String

Le texte de l'élément.The text of the item.

imageKey
String String String String

Clé de l'image à afficher pour l'élément.The key of the image to display for the item.

Retours

ListViewItem ajouté à la collection.The ListViewItem added to the 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.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection.

Add(String, String, Int32) Add(String, String, Int32) Add(String, String, Int32) 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.Creates an item with the specified key, text, and image and adds an item to the 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 String String String

Nom de l'élément.The name of the item.

text
String String String String

Le texte de l'élément.The text of the item.

imageIndex
Int32 Int32 Int32 Int32

Index de l'image à afficher pour l'élément.The index of the image to display for the item.

Retours

ListViewItem ajouté à la collection.The ListViewItem added to the 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.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. La Name propriété correspond à la clé d’un ListViewItem dans le ListView.ListViewItemCollection.The Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

La Add méthode affecte à Name la propriété la clé spécifiée, de sorte que l’élément peut être récupéré par son index ou par sa clé.The Add method sets the Name property to the specified key, so the item can be retrieved by its index or by key.

Add(String, String, String) Add(String, String, String) Add(String, String, String) 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.Creates an item with the specified key, text, and image, and adds it to the 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 String String String

Nom de l'élément.The name of the item.

text
String String String String

Le texte de l'élément.The text of the item.

imageKey
String String String String

Clé de l'image à afficher pour l'élément.The key of the image to display for the item.

Retours

ListViewItem ajouté à la collection.The ListViewItem added to the collection.

Remarques

La Name propriété correspond à la clé d’un ListViewItem dans le ListView.ListViewItemCollection.The Name property corresponds to the key for a ListViewItem in the 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.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. La Add méthode affecte la Name valeur à la propriété de l’élément à la clé spécifiée, de sorte que l’élément peut être récupéré par son index ou par sa clé.The Add method sets the Name property of the item to the specified key, so the item can be retrieved by its index or by key.

S’applique à