ListView.ListViewItemCollection Klasa

Definicja

Reprezentuje kolekcję elementów w ListView kontrolce lub przypisany ListViewGroupdo.Represents the collection of items in a ListView control or assigned to a ListViewGroup.

public: ref class ListView::ListViewItemCollection : System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class ListView.ListViewItemCollection : System.Collections.IList
type ListView.ListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class ListView.ListViewItemCollection
Implements IList
Dziedziczenie
ListView.ListViewItemCollection
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu pokazuje, ListView.ListViewItemCollectionjak dodać elementy do.The following code example demonstrates how to add items to a ListView.ListViewItemCollection. Należy pamiętać, Items że ListView1 właściwość jest typu ListView.ListViewItemCollection.Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. Aby uruchomić ten przykład, wklej następujący kod do ListView formularza, który zawiera obiekt o nazwie ListView1 i TextBox nazwa TextBox1.To run this example, paste the following code into a form that contains a ListView object named ListView1 and a TextBox named TextBox1. Load Wywołaj InitializeListView metodę z konstruktora lub procedury obsługi zdarzeń.Call the InitializeListView method from the form's constructor or Load event handler.

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

Zapisuje elementy wyświetlane ListView wListViewGroupkontrolce lub przypisane do. ListView.ListViewItemCollectionA ListView.ListViewItemCollection stores the items displayed in a ListView control or assigned to a ListViewGroup. Istnieją dwie inne kolekcje zdefiniowane w obrębie ListView klasy, które umożliwiają określenie, które elementy są zaznaczone ListView w formancie.There are two other collections defined within the ListView class that enable you to determine what items are selected within a ListView control. ListView.SelectedIndexCollection ListView ListView ListView.ListViewItemCollection Klasa zawiera właściwości i metody określania elementów wybranych w kontrolce, podczas gdy Klasa umożliwia określenie, jakie indeksy w kontrolce są ListView.SelectedListViewItemCollection niezaznaczone.The ListView.SelectedListViewItemCollection class provides properties and methods for determining what items are selected in a ListView control, while the ListView.SelectedIndexCollection class enables you to determine what indexes within the ListView.ListViewItemCollection of a ListView control are selected. 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.In addition to selection collection classes, there are also two classes that enable you to determine what items are checked (when the CheckBoxes property of the ListView control is set to true) within this collection.

Istnieje kilka sposobów dodawania elementów do kolekcji.There are a number of ways to add items to the collection. Add Metoda dodaje pojedynczy element do kolekcji.The Add method adds a single item to the collection. Aby dodać liczbę elementów do kolekcji, należy utworzyć tablicę elementów i przekazać ją do AddRange metody.To add a number of items to the collection, you create an array of items and pass it to the AddRange method. Jeśli chcesz wstawić element w określonej lokalizacji w kolekcji, możesz użyć Insert metody.If you want to insert an item at a specific location in the collection, you can use the Insert method. Aby usunąć elementy, można użyć Remove metody RemoveAt lub metody, Jeśli wiesz, gdzie znajduje się w kolekcji.To remove items, you can use either the Remove method or the RemoveAt method if you know where the item is located in the collection. Metoda umożliwia usunięcie wszystkich elementów z kolekcji zamiast Remove używać metody do usuwania pojedynczego elementu jednocześnie. ClearThe Clear method enables you to remove all items from the collection instead of using the Remove method to remove a single item at a time.

Oprócz metod i właściwości do dodawania i usuwania elementów, ListView.ListViewItemCollection udostępnia również metody znajdowania elementów w kolekcji.In addition to methods and properties for adding and removing items, the ListView.ListViewItemCollection also provides methods to find items in the collection. Contains Metoda pozwala określić, czy element jest członkiem kolekcji.The Contains method enables you to determine whether an item is a member of the collection. Gdy wiesz, że element znajduje się w kolekcji, możesz użyć IndexOf metody, aby określić, gdzie element znajduje się w kolekcji.Once you know that the item is located in the collection, you can use the IndexOf method to determine where the item is located in the collection.

Konstruktory

ListView.ListViewItemCollection(ListView)

Inicjuje nowe wystąpienie klasy ListView.ListViewItemCollection klasy.Initializes a new instance of the ListView.ListViewItemCollection class.

Właściwości

Count

Pobiera liczbę elementów w kolekcji.Gets the number of items in the collection.

IsReadOnly

Pobiera wartość wskazującą, czy kolekcja jest tylko do odczytu.Gets a value indicating whether the collection is read-only.

Item[Int32]

Pobiera lub ustawia element o określonym indeksie w kolekcji.Gets or sets the item at the specified index within the collection.

Item[String]

Pobiera element z określonym kluczem.Retrieves the item with the specified key.

Metody

Add(ListViewItem)

Dodaje istniejący ListViewItem element do kolekcji.Adds an existing ListViewItem to the collection.

Add(String)

Tworzy element z określonym tekstem i dodaje go do kolekcji.Creates an item with the specified text and adds it to the collection.

Add(String, Int32)

Tworzy element z określonym tekstem i obrazem, a następnie dodaje go do kolekcji.Creates an item with the specified text and image and adds it to the collection.

Add(String, String)

Tworzy element z określonym tekstem i obrazem, a następnie dodaje go do kolekcji.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32)

Tworzy element z określonym kluczem, tekstem i obrazem, a następnie dodaje element do kolekcji.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String)

Tworzy element z określonym kluczem, tekstem i obrazem, a następnie dodaje go do kolekcji.Creates an item with the specified key, text, and image, and adds it to the collection.

AddRange(ListView+ListViewItemCollection)

Dodaje kolekcję elementów do kolekcji.Adds a collection of items to the collection.

AddRange(ListViewItem[])

Dodaje tablicę ListViewItem obiektów do kolekcji.Adds an array of ListViewItem objects to the collection.

Clear()

Usuwa wszystkie elementy z kolekcji.Removes all items from the collection.

Contains(ListViewItem)

Określa, czy określony element znajduje się w kolekcji.Determines whether the specified item is located in the collection.

ContainsKey(String)

Określa, czy kolekcja zawiera element z określonym kluczem.Determines whether the collection contains an item with the specified key.

CopyTo(Array, Int32)

Kopiuje całą kolekcję do istniejącej tablicy w określonej lokalizacji w tablicy.Copies the entire collection into an existing array at a specified location within the array.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Find(String, Boolean)

Wyszukuje elementy, których nazwa pasuje do określonego klucza, opcjonalnie przeszukując elementy.Searches for items whose name matches the specified key, optionally searching subitems.

GetEnumerator()

Zwraca moduł wyliczający, który będzie używany do iteracji w kolekcji elementów.Returns an enumerator to use to iterate through the item collection.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IndexOf(ListViewItem)

Zwraca indeks w kolekcji określonego elementu.Returns the index within the collection of the specified item.

IndexOfKey(String)

Pobiera indeks elementu z określonym kluczem.Retrieves the index of the item with the specified key.

Insert(Int32, ListViewItem)

Wstawia istniejący ListViewItem do kolekcji o określonym indeksie.Inserts an existing ListViewItem into the collection at the specified index.

Insert(Int32, String)

Tworzy nowy element i wstawia go do kolekcji o określonym indeksie.Creates a new item and inserts it into the collection at the specified index.

Insert(Int32, String, Int32)

Tworzy nowy element o określonym indeksie obrazu i wstawia go do kolekcji o określonym indeksie.Creates a new item with the specified image index and inserts it into the collection at the specified index.

Insert(Int32, String, String)

Tworzy nowy element z określonym tekstem i obrazem, a następnie wstawia go w kolekcji pod określonym indeksem.Creates a new item with the specified text and image and inserts it in the collection at the specified index.

Insert(Int32, String, String, Int32)

Tworzy nowy element z określonym kluczem, tekstem i obrazem, a następnie wstawia go w kolekcji pod określonym indeksem.Creates a new item with the specified key, text, and image, and inserts it in the collection at the specified index.

Insert(Int32, String, String, String)

Tworzy nowy element z określonym kluczem, tekstem i obrazem, a następnie dodaje go do kolekcji o określonym indeksie.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Objectelementu.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Remove(ListViewItem)

Usuwa określony element z kolekcji.Removes the specified item from the collection.

RemoveAt(Int32)

Usuwa element o określonym indeksie w kolekcji.Removes the item at the specified index within the collection.

RemoveByKey(String)

Usuwa element z określonym kluczem z kolekcji.Removes the item with the specified key from the collection.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.IsSynchronized

Pobiera wartość wskazującą, czy dostęp do kolekcji jest synchronizowany (bezpieczny wątkowo).Gets a value indicating whether access to the collection is synchronized (thread safe).

ICollection.SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji kontrolek.Gets an object that can be used to synchronize access to the collection of controls.

IList.Add(Object)

Dodaje istniejący obiekt do kolekcji.Adds an existing object to the collection.

IList.Contains(Object)

Określa, czy określony element znajduje się w kolekcji.Determines whether the specified item is in the collection.

IList.IndexOf(Object)

Zwraca indeks w kolekcji określonego elementu.Returns the index within the collection of the specified item.

IList.Insert(Int32, Object)

Wstawia obiekt do kolekcji o określonym indeksie.Inserts an object into the collection at the specified index.

IList.IsFixedSize

Pobiera wartość wskazującą, czy kolekcja ma stały rozmiar.Gets a value indicating whether the collection has a fixed size.

IList.Item[Int32]

Pobiera lub ustawia ListViewItem określony indeks w kolekcji.Gets or sets the ListViewItem at the specified index within the collection.

IList.Remove(Object)

Usuwa określony element z kolekcji.Removes the specified item from the collection.

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerable KonwertujeIQueryabledo.Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też