ListView.ListViewItemCollection Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ListView.ListViewItemCollection.cs

Représente la collection d’éléments d’un ListView contrôle 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 type 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

A 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 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.ListViewItemCollectionListView contrôle sélectionnés. Outre les 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 CheckBoxes propriété du ListView contrôle est définie sur true) dans cette collection.

Il existe plusieurs façons d’ajouter des éléments à la collection. La Add méthode ajoute un élément unique à 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 méthode pour supprimer un seul élément à la Remove fois.

En plus des méthodes et des propriétés pour l’ajout et la suppression d’éléments, les ListView.ListViewItemCollection méthodes permettent également 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

Nom	Description
ListView.ListViewItemCollection(ListView)	Initialise une nouvelle instance de la classe ListView.ListViewItemCollection.

Propriétés

Nom	Description
Count	Obtient le nombre d'éléments dans 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

Nom	Description
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, 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, String)	Crée un élément avec 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.
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’intégralité de la collection dans un tableau existant à un emplacement spécifié dans le tableau.
Find(String, Boolean)	Recherche les éléments dont le nom correspond à la clé spécifiée, éventuellement en recherchant des sous-éléments.
GetEnumerator()	Retourne un énumérateur à utiliser pour itérer dans la collection d’éléments.
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 un existant ListViewItem dans la collection à l’index spécifié.
Insert(Int32, String, Int32)	Crée un élément avec l’index d’image spécifié 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é.
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)	Crée un élément et l’insère dans la collection à l’index spécifié.
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.

Implémentations d’interfaces explicites

Nom	Description
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 a une taille fixe.
IList.Item[Int32]	Obtient ou définit l’index ListViewItem spécifié dans la collection.
IList.Remove(Object)	Supprime l’élément spécifié de la collection.

Voir aussi

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection