ListView.ListViewItemCollection Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt die Auflistung von Elementen dar, die in einem ListView-Steuerelement enthalten oder einer ListViewGroup zugewiesen sind.

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

public 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

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

Public Class ListView.ListViewItemCollection
Implements IList

Vererbung: Object
ListView.ListViewItemCollection

Attribute: ListBindableAttribute

Implementiert: ICollection IEnumerable IList

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Einem Elemente ListView.ListViewItemCollectionhinzugefügt werden. Beachten Sie, dass die Items -Eigenschaft von ListView1 vom Typ ListView.ListViewItemCollectionist. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, das ein ListView -Objekt mit dem Namen ListView1 und einen TextBox mit dem Namen TextBox1enthält. Rufen Sie die InitializeListView -Methode aus dem Konstruktor oder Load Ereignishandler des Formulars auf.

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

Hinweise

Ein ListView.ListViewItemCollection speichert die Elemente, die in einem ListView -Steuerelement angezeigt oder einem ListViewGroupzugewiesen sind. In der ListView -Klasse sind zwei weitere Auflistungen definiert, mit denen Sie bestimmen können, welche Elemente innerhalb eines ListView Steuerelements ausgewählt sind. Die ListView.SelectedListViewItemCollection -Klasse stellt Eigenschaften und Methoden bereit, um zu bestimmen, welche Elemente in einem ListView Steuerelement ausgewählt sind, während Sie mit der ListView.SelectedIndexCollection -Klasse bestimmen können, welche Indizes innerhalb ListView.ListViewItemCollection eines ListView Steuerelements ausgewählt sind. Zusätzlich zu den Auswahlauflistungsklassen gibt es auch zwei Klassen, mit denen Sie bestimmen können, welche Elemente in dieser Auflistung überprüft werden (wenn die CheckBoxes -Eigenschaft des ListView Steuerelements auf truefestgelegt ist).

Es gibt eine Reihe von Möglichkeiten, der Auflistung Elemente hinzuzufügen. Die Add -Methode fügt der Auflistung ein einzelnes Element hinzu. Um der Auflistung eine Reihe von Elementen hinzuzufügen, erstellen Sie ein Array von Elementen und übergeben es an die AddRange -Methode. Wenn Sie ein Element an einer bestimmten Stelle in der Auflistung einfügen möchten, können Sie die Insert -Methode verwenden. Zum Entfernen von Elementen können Sie entweder die Remove -Methode oder die RemoveAt -Methode verwenden, wenn Sie wissen, wo sich das Element in der Auflistung befindet. Mit Clear der -Methode können Sie alle Elemente aus der Auflistung entfernen, anstatt die Remove -Methode zu verwenden, um jeweils ein einzelnes Element zu entfernen.

Zusätzlich zu Methoden und Eigenschaften zum Hinzufügen und Entfernen von Elementen stellt auch ListView.ListViewItemCollection Methoden zum Suchen von Elementen in der Auflistung bereit. Mit Contains der -Methode können Sie bestimmen, ob ein Element ein Element der Auflistung ist. Sobald Sie wissen, dass sich das Element in der Auflistung befindet, können Sie die IndexOf -Methode verwenden, um zu bestimmen, wo sich das Element in der Auflistung befindet.

Konstruktoren

ListView.ListViewItemCollection(ListView)

Initialisiert eine neue Instanz der ListView.ListViewItemCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Elemente in der Auflistung ab.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.
Item[Int32]	Ruft das Element am angegebenen Index in der Auflistung ab oder legt dieses fest.
Item[String]	Ruft das Element mit dem angegebenen Schlüssel ab.

Methoden

Add(ListViewItem)	Fügt der Auflistung ein vorhandenes ListViewItem hinzu.
Add(String)	Erstellt ein Element mit dem angegebenen Text und fügt es der Auflistung hinzu.
Add(String, Int32)	Erstellt ein Element mit dem angegebenen Text und dem Bild und fügt es der Auflistung hinzu.
Add(String, String)	Erstellt ein Element mit dem angegebenen Text und dem Bild und fügt es der Auflistung hinzu.
Add(String, String, Int32)	Erstellt ein Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt der Auflistung ein Element hinzu.
Add(String, String, String)	Erstellt ein Element mit dem angegebenen Schlüssel, Text und Bild und fügt es der Auflistung hinzu.
AddRange(ListView+ListViewItemCollection)	Fügt der Auflistung eine Auflistung von Elementen hinzu.
AddRange(ListViewItem[])	Fügt der Auflistung ein Array von ListViewItem-Objekten hinzu.
Clear()	Entfernt alle Elemente aus der Auflistung.
Contains(ListViewItem)	Bestimmt, ob das angegebene Element in der Auflistung enthalten ist.
ContainsKey(String)	Bestimmt, ob die Auflistung ein Element mit dem angegebenen Schlüssel enthält.
CopyTo(Array, Int32)	Kopiert die gesamte Auflistung an eine angegebene Position in einem vorhandenen Array.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Find(String, Boolean)	Sucht nach Elementen, deren Name mit dem angegebenen Schlüssel übereinstimmt; optional wird nach Unterelementen gesucht.
GetEnumerator()	Gibt einen Enumerator zurück, mit dem die Elementauflistung durchlaufen werden soll.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(ListViewItem)	Gibt den Index des angegebenen Elements in der Auflistung zurück.
IndexOfKey(String)	Ruft den Index des Elements mit dem angegebenen Schlüssel ab.
Insert(Int32, ListViewItem)	Fügt ein bestehendes ListViewItem am angegebenen Index in die Auflistung ein.
Insert(Int32, String)	Erstellt ein neues Element und fügt es am angegebenen Index in die Auflistung ein.
Insert(Int32, String, Int32)	Erstellt ein neues Element mit dem angegebenen Bildtext und fügt es an der angegebenen Indexposition in die Auflistung ein.
Insert(Int32, String, String)	Erstellt ein neues Element mit dem dem angegebenen Text und dem angegebenen Bild und fügt es am angegebenen Index in die Auflistung ein.
Insert(Int32, String, String, Int32)	Erstellt ein neues Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt es am angegebenen Index in die Auflistung ein.
Insert(Int32, String, String, String)	Erstellt ein neues Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt es der Auflistung am angegebenen Index hinzu.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(ListViewItem)	Entfernt das angegebene Element aus der Auflistung.
RemoveAt(Int32)	Entfernt das Element am angegebenen Index in der Auflistung.
RemoveByKey(String)	Entfernt das Element mit dem angegebenen Schlüssel aus der Auflistung.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert ist (threadsicher).
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die Steuerelementauflistung synchronisiert werden kann
IList.Add(Object)	Fügt der Auflistung ein vorhandenes Objekt hinzu.
IList.Contains(Object)	Bestimmt, ob das angegebene Element in der Auflistung vorhanden ist.
IList.IndexOf(Object)	Gibt den Index des angegebenen Elements in der Auflistung zurück.
IList.Insert(Int32, Object)	Fügt ein Objekt am angegebenen Index in die Auflistung ein.
IList.IsFixedSize	Ruft einen Wert ab, der angibt, ob die Auflistung eine feste Größe aufweist.
IList.Item[Int32]	Ruft eine ListViewItem am angegebenen Index in der Auflistung ab oder legt diese fest.
IList.Remove(Object)	Entfernt das angegebene Element aus der Auflistung.

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für: