Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListView.ListViewItemCollection classe

 

Date de publication : novembre 2016

Représente la collection d’éléments dans un contrôle ListView ou affectée à un ListViewGroup.

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

System.Object
  System.Windows.Forms.ListView.ListViewItemCollection

[ListBindableAttribute(false)]
public class ListViewItemCollection : IList, ICollection, IEnumerable

NomDescription
System_CAPS_pubmethodListView.ListViewItemCollection(ListView)

Initialise une nouvelle instance de la classe ListView.ListViewItemCollection.

NomDescription
System_CAPS_pubpropertyCount

Obtient le nombre d’éléments de la collection.

System_CAPS_pubpropertyIsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.

System_CAPS_pubpropertyItem[Int32]

Obtient ou définit l’élément à l’index spécifié dans la collection.

System_CAPS_pubpropertyItem[String]

Récupère l’élément avec la clé spécifiée.

NomDescription
System_CAPS_pubmethodAdd(ListViewItem)

Ajoute un fichier ListViewItem à la collection.

System_CAPS_pubmethodAdd(String)

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

System_CAPS_pubmethodAdd(String, Int32)

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

System_CAPS_pubmethodAdd(String, String)

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

System_CAPS_pubmethodAdd(String, String, Int32)

Crée un élément avec la clé spécifiée, text et image et ajoute un élément à la collection.

System_CAPS_pubmethodAdd(String, String, String)

Crée un élément avec la clé spécifiée, text et image et l’ajoute à la collection.

System_CAPS_pubmethodAddRange(ListViewItem[])

Ajoute un tableau de ListViewItem objets à la collection.

System_CAPS_pubmethodAddRange(ListView.ListViewItemCollection)

Ajoute une collection d’éléments à la collection.

System_CAPS_pubmethodClear()

Supprime tous les éléments de la collection.

System_CAPS_pubmethodContains(ListViewItem)

Détermine si l’élément spécifié se trouve dans la collection.

System_CAPS_pubmethodContainsKey(String)

Détermine si la collection contient un élément avec la clé spécifiée.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copie la collection entière dans un tableau existant à un emplacement spécifié dans le tableau.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection.(Hérité de Object.)

System_CAPS_pubmethodFind(String, Boolean)

Recherche des éléments dont le nom correspond à la clé spécifiée, en recherchant éventuellement des sous-éléments.

System_CAPS_pubmethodGetEnumerator()

Retourne un énumérateur qui peut être utilisé pour parcourir la collection d’éléments.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodIndexOf(ListViewItem)

Retourne l’index dans la collection de l’élément spécifié.

System_CAPS_pubmethodIndexOfKey(String)

Récupère l’index de l’élément avec la clé spécifiée.

System_CAPS_pubmethodInsert(Int32, ListViewItem)

Insère un existant ListViewItem dans la collection à l’index spécifié.

System_CAPS_pubmethodInsert(Int32, String)

Crée un nouvel élément et l’insère dans la collection à l’index spécifié.

System_CAPS_pubmethodInsert(Int32, String, Int32)

Crée un élément avec l’index d’image spécifiés et l’insère dans la collection à l’index spécifié.

System_CAPS_pubmethodInsert(Int32, String, String)

Crée un élément avec le texte spécifié et l’image et l’insère dans la collection à l’index spécifié.

System_CAPS_pubmethodInsert(Int32, String, String, Int32)

Crée un élément avec la clé spécifiée, text et image et l’insère dans la collection à l’index spécifié.

System_CAPS_pubmethodInsert(Int32, String, String, String)

Crée un élément avec la clé spécifiée, text et image et l’ajoute à la collection à l’index spécifié.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodRemove(ListViewItem)

Supprime l'élément spécifié de la collection.

System_CAPS_pubmethodRemoveAt(Int32)

Supprime l’élément à l’index spécifié dans la collection.

System_CAPS_pubmethodRemoveByKey(String)

Supprime l’élément avec la clé spécifiée de la collection.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Ajoute un objet existant à la collection.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Détermine si l’élément spécifié est dans la collection.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Retourne l’index dans la collection de l’élément spécifié.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Insère un objet dans la collection à l’index spécifié.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Supprime l’élément spécifié de la collection.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection de contrôles.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient une valeur indiquant si la collection est de taille fixe.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient ou définit le ListViewItem à l’index spécifié dans la collection.

NomDescription
System_CAPS_pubmethodAsParallel()

Surchargé. Active la parallélisation d'une requête.(Défini par ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Surchargé. Convertit un IEnumerable à un IQueryable.(Défini par Queryable.)

System_CAPS_pubmethodCast<TResult>()

Convertit les éléments d’un IEnumerable au type spécifié.(Défini par Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtre les éléments d’un IEnumerable basé sur un type spécifié.(Défini par Enumerable.)

Un ListView.ListViewItemCollection stocke les éléments affichés dans un ListView contrôler ou attribuée à un ListViewGroup. Il existe deux autres collections définies dans la ListView classe qui vous permettent de déterminer les éléments sélectionnés dans un ListView contrôle. La ListView.SelectedListViewItemCollection classe fournit des propriétés et méthodes pour déterminer les éléments sélectionnés dans un ListView contrôle, tandis que la ListView.SelectedIndexCollection classe vous permet de déterminer les index dans le ListView.ListViewItemCollection d’un ListView contrôle sont sélectionnées. En plus des classes de collection de sélection, il existe également deux classes qui vous permettent de déterminer les éléments sélectionnés (lorsque la CheckBoxes propriété de la ListView contrôle est défini sur true) au sein de cette collection.

Il existe plusieurs façons d’ajouter des éléments à la collection. Le Add méthode ajoute un élément unique à la collection. Pour ajouter un nombre d’éléments à la collection, vous créez un tableau d’éléments et passez à le AddRange (méthode). Si vous souhaitez insérer un élément à un emplacement spécifique dans la collection, vous pouvez utiliser la Insert méthode. Pour supprimer des éléments, vous pouvez utiliser la Remove méthode ou RemoveAt méthode si vous savez où se trouve l’élément dans la collection. Le Clear méthode vous permet de supprimer tous les éléments de la collection au lieu d’utiliser la Remove méthode pour supprimer un seul élément à la fois.

En plus des méthodes et propriétés pour ajouter et supprimer des éléments, le ListView.ListViewItemCollection fournit également des méthodes pour rechercher des éléments dans la collection. Le Contains méthode vous permet de déterminer si un élément est un membre de la collection. Une fois que vous savez que l’élément se trouve dans la collection, vous pouvez utiliser la IndexOf méthode afin de déterminer où se trouve l’élément dans la collection.

L’exemple de code suivant montre comment ajouter des éléments à un ListView.ListViewItemCollection. Notez que le Items propriété du ListView1 est de type ListView.ListViewItemCollection. Pour exécuter cet exemple, collez le code suivant dans un formulaire contenant un ListView objet nommé ListView1 et un TextBox nommé TextBox1. Appelez le InitializeListView méthode à partir du constructeur du formulaire ou Load Gestionnaire d’événements.

// This method adds two columns to the ListView, setting the Text 
// and TextAlign, and Width properties of each ColumnHeader.  The 
// HeaderStyle property is set to NonClickable since the ColumnClick 
// event is not handled.  Finally the method adds ListViewItems and 
// SubItems to each column.
private void InitializeListView()
{
	this.ListView1 = new System.Windows.Forms.ListView();
	this.ListView1.BackColor = System.Drawing.SystemColors.Control;
	this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
	this.ListView1.Location = new System.Drawing.Point(0, 0);
	this.ListView1.Name = "ListView1";
	this.ListView1.Size = new System.Drawing.Size(292, 130);
	this.ListView1.TabIndex = 0;
	this.ListView1.View = System.Windows.Forms.View.Details;
	this.ListView1.MultiSelect = true;
	this.ListView1.HideSelection = false;
	this.ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;

	ColumnHeader columnHeader1 = new ColumnHeader();
	columnHeader1.Text = "Breakfast Item";
	columnHeader1.TextAlign = HorizontalAlignment.Left;
	columnHeader1.Width = 146;

 	ColumnHeader columnHeader2 = new ColumnHeader();
	columnHeader2.Text = "Price Each";
	columnHeader2.TextAlign = HorizontalAlignment.Center;
	columnHeader2.Width = 142;

	this.ListView1.Columns.Add(columnHeader1);
	this.ListView1.Columns.Add(columnHeader2);

	string[] foodList = new string[]{"Juice", "Coffee", 
		"Cereal & Milk", "Fruit Plate", "Toast & Jelly", 
		"Bagel & Cream Cheese"};
	string[] foodPrice = new string[]{"1.09", "1.09", "2.19", 
		"2.49", "1.49", "1.49"};

	for(int count=0; count < foodList.Length; count++)
	{
		ListViewItem listItem = new ListViewItem(foodList[count]);
		listItem.SubItems.Add(foodPrice[count]);
		ListView1.Items.Add(listItem);
	}
	this.Controls.Add(ListView1);
}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: