ListView.ListViewItemCollection Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rappresenta la raccolta di elementi in un controllo ListView o assegnata a 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

Ereditarietà

Object

ListView.ListViewItemCollection

Attributi

ListBindableAttribute

Implementazioni

ICollection IEnumerable IList

Esempio

Nell'esempio di codice seguente viene illustrato come aggiungere elementi a un ListView.ListViewItemCollectionoggetto . Si noti che la Items proprietà di è di ListView1 tipo ListView.ListViewItemCollection. Per eseguire questo esempio, incollare il codice seguente in un modulo contenente un ListView oggetto denominato e un TextBox oggetto denominato TextBox1ListView1 . Chiamare il InitializeListView metodo dal costruttore o Load dal gestore eventi del modulo.

// 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

Commenti

Un ListView.ListViewItemCollection archivia gli elementi visualizzati in un ListView controllo o assegnati a un ListViewGroupoggetto . Esistono due altre raccolte definite all'interno della ListView classe che consentono di determinare quali elementi sono selezionati all'interno di un ListView controllo. La ListView.SelectedListViewItemCollection classe fornisce proprietà e metodi per determinare gli elementi selezionati in un controllo, mentre la ListView.SelectedIndexCollection classe consente di determinare quali indici all'interno ListView.ListViewItemCollection di un ListViewListView controllo sono selezionati. Oltre alle classi di raccolta di selezione, sono disponibili anche due classi che consentono di determinare quali elementi vengono controllati (quando la CheckBoxes proprietà del controllo è impostata su true) all'interno di ListView questa raccolta.

Esistono diversi modi per aggiungere elementi alla raccolta. Il Add metodo aggiunge un singolo elemento alla raccolta. Per aggiungere un numero di elementi alla raccolta, creare una matrice di elementi e passarla al AddRange metodo. Se si vuole inserire un elemento in una posizione specifica nella raccolta, è possibile usare il Insert metodo . Per rimuovere gli elementi, è possibile usare il metodo o il RemoveRemoveAt metodo se si conosce dove si trova l'elemento nella raccolta. Il Clear metodo consente di rimuovere tutti gli elementi dalla raccolta anziché usare il Remove metodo per rimuovere un singolo elemento alla volta.

Oltre ai metodi e alle proprietà per l'aggiunta e la rimozione di elementi, ListView.ListViewItemCollection fornisce anche metodi per trovare elementi nella raccolta. Il Contains metodo consente di determinare se un elemento è un membro della raccolta. Dopo aver appreso che l'elemento si trova nella raccolta, è possibile usare il IndexOf metodo per determinare dove si trova l'elemento nella raccolta.

Costruttori

ListView.ListViewItemCollection(ListView)

Inizializza una nuova istanza della classe ListView.ListViewItemCollection.

Proprietà

Count	Ottiene il numero di elementi nella raccolta.
IsReadOnly	Ottiene un valore che indica se la raccolta è di sola lettura.
Item[Int32]	Ottiene o imposta l'elemento presente in corrispondenza dell'indice specificato all'interno dell'insieme.
Item[String]	Recupera l'elemento con la chiave specificata.

Metodi

Add(ListViewItem)	Aggiunge un oggetto ListViewItem esistente all'insieme.
Add(String)	Crea un elemento con il testo specificato e lo aggiunge all'insieme.
Add(String, Int32)	Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.
Add(String, String)	Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.
Add(String, String, Int32)	Crea un elemento con la chiave, il testo e l'immagine specificati e aggiunge un elemento all'insieme.
Add(String, String, String)	Crea un elemento con la chiave, il testo e l'immagine specificati e lo aggiunge all'insieme.
AddRange(ListView+ListViewItemCollection)	Aggiunge un insieme di elementi all'insieme.
AddRange(ListViewItem[])	Aggiunge una matrice di oggetti ListViewItem all'insieme.
Clear()	Rimuove tutti gli elementi dalla raccolta.
Contains(ListViewItem)	Consente di determinare se l'elemento specificato è contenuto nell'insieme.
ContainsKey(String)	Determina se l'insieme contiene un elemento con la chiave specificata.
CopyTo(Array, Int32)	Copia l'intero insieme in una posizione specifica all'interno di una matrice esistente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Find(String, Boolean)	Cerca gli elementi il cui nome corrisponde alla chiave specificata, facoltativamente esegue anche la ricerca di elementi secondari.
GetEnumerator()	Restituisce un enumeratore da utilizzare per scorrere l'insieme degli elementi.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(ListViewItem)	Restituisce l'indice all'interno dell'insieme dell'elemento specificato.
IndexOfKey(String)	Recupera l'indice dell'elemento con la chiave specificata.
Insert(Int32, ListViewItem)	Inserisce nell'insieme un oggetto ListViewItem esistente in corrispondenza dell'indice specificato.
Insert(Int32, String)	Crea un nuovo elemento e lo inserisce nell'insieme in corrispondenza dell'indice specificato.
Insert(Int32, String, Int32)	Crea un nuovo elemento con l'indice di immagine specificato e lo inserisce nell'insieme in corrispondenza dell'indice specificato.
Insert(Int32, String, String)	Crea un nuovo elemento con il testo e l'immagine specificati e lo inserisce nell'insieme in corrispondenza dell'indice specificato.
Insert(Int32, String, String, Int32)	Crea un nuovo elemento con la chiave, il testo e l'immagine indicati e lo inserisce nell'insieme in corrispondenza dell'indice specificato.
Insert(Int32, String, String, String)	Crea un nuovo elemento con la chiave, il testo e l'immagine indicati e lo aggiunge all'insieme in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(ListViewItem)	Rimuove l'elemento specificato dalla raccolta.
RemoveAt(Int32)	Rimuove dall'insieme l'elemento presente in corrispondenza dell'indice specificato.
RemoveByKey(String)	Rimuove dall'insieme l'elemento con la chiave specificata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato (thread-safe).
ICollection.SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'insieme dei controlli.
IList.Add(Object)	Aggiunge un oggetto esistente all'insieme.
IList.Contains(Object)	Determina se l'elemento specificato è presente nell'insieme.
IList.IndexOf(Object)	Restituisce l'indice all'interno dell'insieme dell'elemento specificato.
IList.Insert(Int32, Object)	Inserisce un oggetto nella raccolta in corrispondenza dell'indice specificato.
IList.IsFixedSize	Ottiene un valore che indica se la dimensione della raccolta è fissa.
IList.Item[Int32]	Ottiene o imposta il gruppo ListViewItem in corrispondenza dell'indice specificato all'interno dell'insieme.
IList.Remove(Object)	Rimuove l'elemento specificato dalla raccolta.

Metodi di estensione

Vedi anche

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection