ListView.ListViewItemCollection Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Reprezentuje kolekcję elementów w kontrolce ListView lub przypisaną do elementu 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

Dziedziczenie

Object

ListView.ListViewItemCollection

Atrybuty

ListBindableAttribute

Implementuje

ICollection IEnumerable IList

Przykłady

W poniższym przykładzie kodu pokazano, jak dodać elementy do elementu ListView.ListViewItemCollection. Należy pamiętać, że Items właściwość typu ListView1 ma typ ListView.ListViewItemCollection. Aby uruchomić ten przykład, wklej następujący kod w formularzu zawierającym ListView obiekt o nazwie ListView1 i TextBox nazwie TextBox1. Wywołaj metodę InitializeListView z konstruktora formularza lub Load procedury obsługi zdarzeń.

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

Uwagi

Element ListView.ListViewItemCollection przechowuje elementy wyświetlane w kontrolce ListView lub przypisane do elementu ListViewGroup. Istnieją dwie inne kolekcje zdefiniowane w ListView klasie, które umożliwiają określenie elementów wybranych w kontrolce ListView . Klasa ListView.SelectedListViewItemCollection udostępnia właściwości i metody określania elementów wybranych w kontrolce ListView , podczas gdy ListView.SelectedIndexCollection klasa umożliwia określenie indeksów w obrębie ListView.ListViewItemCollection kontrolki ListView . Oprócz klas kolekcji wyboru istnieją również dwie klasy, które umożliwiają określenie, które elementy są sprawdzane (gdy CheckBoxes właściwość ListView kontrolki jest ustawiona na true) w tej kolekcji.

Istnieje wiele sposobów dodawania elementów do kolekcji. Metoda Add dodaje pojedynczy element do kolekcji. Aby dodać kilka elementów do kolekcji, należy utworzyć tablicę elementów i przekazać ją do AddRange metody . Jeśli chcesz wstawić element w określonej lokalizacji w kolekcji, możesz użyć Insert metody . Aby usunąć elementy, możesz użyć Remove metody lub RemoveAt metody , jeśli wiesz, gdzie element znajduje się w kolekcji. Metoda Clear umożliwia usunięcie wszystkich elementów z kolekcji zamiast używania Remove metody w celu usunięcia pojedynczego elementu naraz.

Oprócz metod i właściwości dodawania i usuwania elementów, ListView.ListViewItemCollection udostępnia również metody znajdowania elementów w kolekcji. Metoda Contains umożliwia określenie, czy element jest elementem członkowskim kolekcji. Gdy już wiesz, że element znajduje się w kolekcji, możesz użyć IndexOf metody , aby określić, gdzie element znajduje się w kolekcji.

Konstruktory

ListView.ListViewItemCollection(ListView)

Inicjuje nowe wystąpienie klasy ListView.ListViewItemCollection.

Właściwości

Count	Pobiera liczbę elementów w kolekcji.
IsReadOnly	Pobiera wartość wskazującą, czy kolekcja jest przeznaczona tylko do odczytu.
Item[Int32]	Pobiera lub ustawia element w określonym indeksie w kolekcji.
Item[String]	Pobiera element z określonym kluczem.

Metody

Add(ListViewItem)	Dodaje istniejący ListViewItem element do kolekcji.
Add(String)	Tworzy element z określonym tekstem i dodaje go do kolekcji.
Add(String, Int32)	Tworzy element z określonym tekstem i obrazem i dodaje go do kolekcji.
Add(String, String)	Tworzy element z określonym tekstem i obrazem i dodaje go do kolekcji.
Add(String, String, Int32)	Tworzy element z określonym kluczem, tekstem i obrazem oraz dodaje element do kolekcji.
Add(String, String, String)	Tworzy element z określonym kluczem, tekstem i obrazem oraz dodaje go do kolekcji.
AddRange(ListView+ListViewItemCollection)	Dodaje kolekcję elementów do kolekcji.
AddRange(ListViewItem[])	Dodaje tablicę ListViewItem obiektów do kolekcji.
Clear()	Usuwa wszystkie elementy z kolekcji.
Contains(ListViewItem)	Określa, czy określony element znajduje się w kolekcji.
ContainsKey(String)	Określa, czy kolekcja zawiera element z określonym kluczem.
CopyTo(Array, Int32)	Kopiuje całą kolekcję do istniejącej tablicy w określonej lokalizacji w tablicy.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Find(String, Boolean)	Wyszukuje elementy, których nazwa jest zgodna z określonym kluczem, opcjonalnie wyszukuje podklucze.
GetEnumerator()	Zwraca moduł wyliczający używany do iterowania po kolekcji elementów.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IndexOf(ListViewItem)	Zwraca indeks w kolekcji określonego elementu.
IndexOfKey(String)	Pobiera indeks elementu z określonym kluczem.
Insert(Int32, ListViewItem)	Wstawia istniejący ListViewItem element do kolekcji w określonym indeksie.
Insert(Int32, String)	Tworzy nowy element i wstawia go do kolekcji w określonym indeksie.
Insert(Int32, String, Int32)	Tworzy nowy element z określonym indeksem obrazu i wstawia go do kolekcji w określonym indeksie.
Insert(Int32, String, String)	Tworzy nowy element z określonym tekstem i obrazem i wstawia go do kolekcji w określonym indeksie.
Insert(Int32, String, String, Int32)	Tworzy nowy element z określonym kluczem, tekstem i obrazem i wstawia go do kolekcji w określonym indeksie.
Insert(Int32, String, String, String)	Tworzy nowy element z określonym kluczem, tekstem i obrazem i dodaje go do kolekcji w określonym indeksie.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Remove(ListViewItem)	Usuwa określony element z kolekcji.
RemoveAt(Int32)	Usuwa element w określonym indeksie w kolekcji.
RemoveByKey(String)	Usuwa element z określonym kluczem z kolekcji.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.IsSynchronized	Pobiera wartość wskazującą, czy dostęp do kolekcji jest synchronizowany (bezpieczny wątek).
ICollection.SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji kontrolek.
IList.Add(Object)	Dodaje istniejący obiekt do kolekcji.
IList.Contains(Object)	Określa, czy określony element znajduje się w kolekcji.
IList.IndexOf(Object)	Zwraca indeks w kolekcji określonego elementu.
IList.Insert(Int32, Object)	Wstawia obiekt do kolekcji w określonym indeksie.
IList.IsFixedSize	Pobiera wartość wskazującą, czy kolekcja ma stały rozmiar.
IList.Item[Int32]	Pobiera lub ustawia ListViewItem wartość w określonym indeksie w kolekcji.
IList.Remove(Object)	Usuwa określony element z kolekcji.

Metody rozszerzania

Zobacz też

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection