ListView.SelectedListViewItemCollection Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Reprezentuje kolekcję wybranych elementów w kontrolce widoku listy.

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

[System.ComponentModel.ListBindable(false)]
public class ListView.SelectedListViewItemCollection : System.Collections.IList

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

Public Class ListView.SelectedListViewItemCollection
Implements IList

Dziedziczenie

Object

ListView.SelectedListViewItemCollection

Atrybuty

ListBindableAttribute

Implementuje

ICollection IEnumerable IList

Przykłady

W poniższym przykładzie kodu pokazano użycie zdarzenia SelectedItems, SelectedIndexChanged i HeaderStyle elementów członkowskich oraz ListView.SelectedListViewItemCollection klasy . Aby uruchomić ten przykład, wklej następujący kod w formularzu zawierającym ListView obiekt o nazwie ListView1 i nazwany TextBoxTextBox1. Wywołaj metodę InitializeListView z konstruktora formularza lub procedury obsługi zdarzeń Load . Ten przykład wymaga prawidłowego skojarzenia programu obsługi zdarzeń ze zdarzeniem SelectedIndexChanged

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

// Uses the SelectedItems property to retrieve and tally the price 
// of the selected menu items.
void ListView1_SelectedIndexChanged_UsingItems( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   ListView::SelectedListViewItemCollection^ breakfast = this->ListView1->SelectedItems;
   double price = 0.0;
   System::Collections::IEnumerator^ myEnum = breakfast->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      ListViewItem^ item = safe_cast<ListViewItem^>(myEnum->Current);
      price += Double::Parse( item->SubItems[ 1 ]->Text );
   }

   // Output the price to TextBox1.
   TextBox1->Text = price.ToString();
}

// Uses the SelectedItems property to retrieve and tally the price 
// of the selected menu items.
private void ListView1_SelectedIndexChanged_UsingItems(
    object sender, System.EventArgs e)
{

    ListView.SelectedListViewItemCollection breakfast = 
        this.ListView1.SelectedItems;
    
    double price = 0.0;
    foreach ( ListViewItem item in breakfast )
    {
        price += Double.Parse(item.SubItems[1].Text);
    }

    // Output the price to TextBox1.
    TextBox1.Text = price.ToString();
}

' Uses the SelectedItems property to retrieve and tally the price 
' of the selected menu items.
Private Sub ListView1_SelectedIndexChanged_UsingItems _
    (ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles ListView1.SelectedIndexChanged

    Dim breakfast As ListView.SelectedListViewItemCollection = _
        Me.ListView1.SelectedItems
    Dim item As ListViewItem
    Dim price As Double = 0.0
    For Each item In breakfast
        price += Double.Parse(item.SubItems(1).Text)
    Next

    ' Output the price to TextBox1.
    TextBox1.Text = CType(price, String)
End Sub

Uwagi

Element ListView.SelectedListViewItemCollection przechowuje zaznaczone elementy w kontrolce ListView . Elementy przechowywane w obiekcie ListView.SelectedListViewItemCollection to elementy zawarte w elemecie ListView.ListViewItemCollection. Magazynuje ListView.ListViewItemCollection wszystkie elementy wyświetlane w elemecie ListView.

W poniższej tabeli przedstawiono przykład ListView.ListViewItemCollection przechowywania elementów elementu ListView , a także ich stanów wyboru w przykładowej ListView kontrolce.

Indeks	Element	Stan zaznaczenia w widoku ListView
0	Element 1	Niezaznaczone
1	Element 2	Wybrane
2	Element 3	Niezaznaczone
3	Element4	Wybrane
4	Element5	Wybrane

Na podstawie przykładu ListView.ListViewItemCollection w poprzedniej tabeli poniższa tabela przedstawia sposób wyświetlania.ListView.SelectedListViewItemCollection

Indeks	Wybrany element w obiekcie ListViewItemCollection
0	Element 2
1	Element4
2	Element5

Za pomocą właściwości i metod tej klasy można wykonywać różne zadania w kolekcji. Metoda Contains umożliwia określenie, czy element z ListView.ListViewItemCollection klasy jest elementem członkowskim ListView.SelectedListViewItemCollectionklasy . Gdy wiesz, że element znajduje się w kolekcji, możesz użyć IndexOf metody , aby określić położenie elementu w elemencie ListView.SelectedListViewItemCollection.

Konstruktory

ListView.SelectedListViewItemCollection(ListView)

Inicjuje nowe wystąpienie klasy ListView.SelectedListViewItemCollection.

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 element w określonym indeksie w kolekcji.
Item[String]	Pobiera element z określonym kluczem z kolekcji.

Metody

Clear()	Usuwa wszystkie elementy z kolekcji.
Contains(ListViewItem)	Określa, czy określony element znajduje się w kolekcji.
ContainsKey(String)	Określa, czy element o określonym kluczu znajduje się w kolekcji.
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)
GetEnumerator()	Zwraca moduł wyliczający, który może służyć do iterowania po wybranej kolekcji elementów.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IndexOf(ListViewItem)	Zwraca indeks w kolekcji określonego elementu.
IndexOfKey(String)	Zwraca indeks pierwszego wystąpienia elementu z określonym kluczem.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
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 element do kolekcji.
IList.Contains(Object)	Określa, czy określony element znajduje się w kolekcji.
IList.IndexOf(Object)	Zwraca indeks w obrębie kolekcji określonego elementu.
IList.Insert(Int32, Object)	Wstawia element do kolekcji w określonym indeksie.
IList.IsFixedSize	Pobiera wartość wskazującą, czy kolekcja ma stały rozmiar.
IList.Item[Int32]	Pobiera lub ustawia obiekt z kolekcji.
IList.Remove(Object)	Usuwa pierwsze wystąpienie określonego elementu z kolekcji.
IList.RemoveAt(Int32)	Usuwa element z kolekcji w określonym indeksie.

Metody rozszerzania