ListView.ListViewItemCollection Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

public: ref class ListView::ListViewItemCollection : System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class ListView.ListViewItemCollection : System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type ListView.ListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class ListView.ListViewItemCollection
Implements IList

Héritage

Object

ListView.ListViewItemCollection

Attributs

ListBindableAttribute

Implémente

ICollection IEnumerable IList

Exemples

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

// 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.
void InitializeListView()
{
   this->ListView1 = gcnew System::Windows::Forms::ListView;
   this->ListView1->BackColor = System::Drawing::SystemColors::Control;
   this->ListView1->Dock = System::Windows::Forms::DockStyle::Top;
   this->ListView1->Location = System::Drawing::Point( 0, 0 );
   this->ListView1->Name = "ListView1";
   this->ListView1->Size = 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 = gcnew ColumnHeader;
   columnHeader1->Text = "Breakfast Item";
   columnHeader1->TextAlign = HorizontalAlignment::Left;
   columnHeader1->Width = 146;
   ColumnHeader^ columnHeader2 = gcnew ColumnHeader;
   columnHeader2->Text = "Price Each";
   columnHeader2->TextAlign = HorizontalAlignment::Center;
   columnHeader2->Width = 142;
   this->ListView1->Columns->Add( columnHeader1 );
   this->ListView1->Columns->Add( columnHeader2 );
   array<String^>^foodList = {"Juice","Coffee","Cereal & Milk","Fruit Plate","Toast & Jelly","Bagel & Cream Cheese"};
   array<String^>^foodPrice = {"1.09","1.09","2.19","2.49","1.49","1.49"};
   for ( int count = 0; count < foodList->Length; count++ )
   {
      ListViewItem^ listItem = gcnew ListViewItem( foodList[ count ] );
      listItem->SubItems->Add( foodPrice[ count ] );
      ListView1->Items->Add( listItem );

   }
   this->Controls->Add( ListView1 );
}

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

' 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 Sub InitializeListView()
    Me.ListView1 = New System.Windows.Forms.ListView
    Me.ListView1.BackColor = System.Drawing.SystemColors.Control
    Me.ListView1.Dock = System.Windows.Forms.DockStyle.Top
    Me.ListView1.Location = New System.Drawing.Point(0, 0)
    Me.ListView1.Name = "ListView1"
    Me.ListView1.Size = New System.Drawing.Size(292, 130)
    Me.ListView1.TabIndex = 0
    Me.ListView1.View = System.Windows.Forms.View.Details
    Me.ListView1.MultiSelect = True
    Me.ListView1.HideSelection = False
    ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable
    Dim columnHeader1 As New ColumnHeader
    With columnHeader1
        .Text = "Breakfast Item"
        .TextAlign = HorizontalAlignment.Left
        .Width = 146
    End With
    Dim columnHeader2 As New ColumnHeader
    With columnHeader2
        .Text = "Price Each"
        .TextAlign = HorizontalAlignment.Center
        .Width = 142
    End With

    Me.ListView1.Columns.Add(columnHeader1)
    Me.ListView1.Columns.Add(columnHeader2)
    Dim foodList() As String = New String() {"Juice", "Coffee", _
        "Cereal & Milk", "Fruit Plate", "Toast & Jelly", _
        "Bagel & Cream Cheese"}
    Dim foodPrice() As String = New String() {"1.09", "1.09", _
        "2.19", "2.49", "1.49", "1.49"}
    Dim count As Integer
    For count = 0 To foodList.Length - 1
        Dim listItem As New ListViewItem(foodList(count))
        listItem.SubItems.Add(foodPrice(count))
        ListView1.Items.Add(listItem)
    Next
    Me.Controls.Add(Me.ListView1)
End Sub

Remarques

Un ListView.ListViewItemCollection stocke les éléments affichés dans un ListView contrôle ou affectés à 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 des méthodes pour déterminer quels éléments sont sélectionnés dans un ListView contrôle, tandis que la ListView.SelectedIndexCollection classe vous permet de déterminer quels index dans le ListView.ListViewItemCollection d’un ListView contrôle sont sélectionnés. En plus des classes de collection de sélection, il existe également deux classes qui vous permettent de déterminer quels éléments sont vérifiés (lorsque la CheckBoxesListView propriété du contrôle est définie sur true) au sein de cette collection.

Il existe plusieurs façons d’ajouter des éléments à la collection. La Add méthode ajoute un seul élément à la collection. Pour ajouter un certain nombre d’éléments à la collection, vous créez un tableau d’éléments et passez-le à la 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 la RemoveAt méthode si vous savez où se trouve l’élément dans la collection. La 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 des propriétés permettant d’ajouter et de supprimer des éléments, le ListView.ListViewItemCollection fournit également des méthodes permettant de rechercher des éléments dans la collection. La Contains méthode vous permet de déterminer si un élément est 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 pour déterminer où se trouve l’élément dans la collection.

Constructeurs

ListView.ListViewItemCollection(ListView)

Initialise une nouvelle instance de la classe ListView.ListViewItemCollection.

Propriétés

Count	Obtient le nombre d’éléments de la collection.
IsReadOnly	Obtient une valeur indiquant si la collection est en lecture seule.
Item[Int32]	Obtient ou définit l'élément à l'index spécifié dans la collection.
Item[String]	Récupère l'élément avec la clé spécifiée.

Méthodes

Add(ListViewItem)	Ajoute un ListViewItem existant à la collection.
Add(String)	Crée un élément avec le texte spécifié et l'ajoute à 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.
AddRange(ListView+ListViewItemCollection)	Ajoute une collection d'éléments à la collection.
AddRange(ListViewItem[])	Ajoute un tableau d'objets ListViewItem à la collection.
Clear()	Supprime tous les éléments de la collection.
Contains(ListViewItem)	Détermine si l'élément spécifié se trouve dans la collection.
ContainsKey(String)	Détermine si la collection contient un élément avec la clé spécifiée.
CopyTo(Array, Int32)	Copie l'ensemble de la collection dans un tableau existant, à un emplacement spécifié dans le tableau.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Find(String, Boolean)	Recherche les éléments dont le nom correspond à la clé spécifiée, en cherchant de manière facultative les sous-éléments.
GetEnumerator()	Retourne un énumérateur qui peut être utilisé pour itérer au sein de la collection d'éléments.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(ListViewItem)	Retourne l'index dans la collection de l'élément spécifié.
IndexOfKey(String)	Récupère l'index de l'élément avec la clé spécifiée.
Insert(Int32, ListViewItem)	Insère dans la collection un ListViewItem existant à l'index spécifié.
Insert(Int32, String)	Crée un nouvel élément et l'insère dans la collection à l'index spécifié.
Insert(Int32, String, Int32)	Crée un nouvel élément muni de l'index d'image spécifié et l'insère dans la collection à l'index spécifié.
Insert(Int32, String, String)	Crée un élément avec le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.
Insert(Int32, String, String, Int32)	Crée un élément avec la clé, le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.
Insert(Int32, String, String, String)	Crée un élément avec la clé, le texte et l'image spécifiés, et l'ajoute à la collection à l'index spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(ListViewItem)	Supprime l’élément spécifié de la collection.
RemoveAt(Int32)	Supprime l'élément à l'index spécifié dans la collection.
RemoveByKey(String)	Supprime l'élément avec la clé spécifiée de la collection.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection de contrôles.
IList.Add(Object)	Ajoute un objet existant à la collection.
IList.Contains(Object)	Détermine si l'élément spécifié se trouve dans la collection.
IList.IndexOf(Object)	Retourne l'index dans la collection de l'élément spécifié.
IList.Insert(Int32, Object)	Insère un objet dans la collection à l'index spécifié.
IList.IsFixedSize	Obtient une valeur indiquant si la collection est de taille fixe.
IList.Item[Int32]	Obtient ou définit ListViewItem à l'index spécifié dans la collection.
IList.Remove(Object)	Supprime l’élément spécifié de la collection.

Méthodes d’extension

Voir aussi

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection