ListView.SelectedListViewItemCollection Classe

Definição

Representa a coleção de itens selecionados em um controle de exibição de lista.Represents the collection of selected items in a list view control.

public: ref class ListView::SelectedListViewItemCollection : System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class ListView.SelectedListViewItemCollection : System.Collections.IList
type ListView.SelectedListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class ListView.SelectedListViewItemCollection
Implements IList
Herança
ListView.SelectedListViewItemCollection
Atributos
Implementações

Exemplos

O exemplo de código a seguir demonstra SelectedItemscomo SelectedIndexChanged usar o, HeaderStyle o evento e ListView.SelectedListViewItemCollection os membros e a classe.The following code example demonstrates using the SelectedItems, SelectedIndexChanged event, and HeaderStyle members and the ListView.SelectedListViewItemCollection class. Para executar este exemplo, Cole o código a seguir em um formulário que contém ListView um objeto ListView1 chamado e TextBox um TextBox1denominado.To run this example, paste the following code in a form that contains a ListView object named ListView1 and a TextBox named TextBox1. Chame o InitializeListView método do construtor do formulário ou do manipulador Load de eventos.Call the InitializeListView method from the form's constructor or the Load event handler. Este exemplo requer que o manipulador de eventos esteja corretamente associado SelectedIndexChanged ao eventoThis example requires that the event handler is correctly associated with the SelectedIndexChanged event

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

Comentários

Um ListView.SelectedListViewItemCollection armazena os itens selecionados em um ListView controle.A ListView.SelectedListViewItemCollection stores the selected items in a ListView control. Os itens armazenados no ListView.SelectedListViewItemCollection são itens contidos ListView.ListViewItemCollectionno.The items stored in the ListView.SelectedListViewItemCollection are items contained in the ListView.ListViewItemCollection. O ListView.ListViewItemCollection armazena todos os itens exibidos ListViewno.The ListView.ListViewItemCollection stores all items displayed in the ListView.

A tabela a seguir mostra um exemplo de como ListView.ListViewItemCollection o armazena os itens ListView do, bem como seus Estados de seleção em um ListView controle de exemplo.The following table shows an example of how the ListView.ListViewItemCollection stores the items of the ListView as well as their selection states in an example ListView control.

ÍndiceIndex ItemItem Estado de seleção na ListViewSelection state in the ListView
00 Item1Item1 Não selecionadoUnselected
11 Item2Item2 SelecionadoSelected
22 Item3Item3 Não selecionadoUnselected
33 Item4Item4 SelecionadoSelected
44 Item5Item5 SelecionadoSelected

Com base no ListView.ListViewItemCollection exemplo na tabela anterior, a tabela a seguir demonstra como o ListView.SelectedListViewItemCollection seria exibido.Based on the ListView.ListViewItemCollection example in the previous table, the following table demonstrates how the ListView.SelectedListViewItemCollection would appear.

ÍndiceIndex Item selecionado no ListViewItemCollectionSelected item in the ListViewItemCollection
00 Item2Item2
11 Item4Item4
22 Item5Item5

Você pode usar as propriedades e os métodos dessa classe para executar uma variedade de tarefas com a coleção.You can use the properties and methods of this class to perform a variety of tasks with the collection. O Contains método permite que você determine se um item ListView.ListViewItemCollection da classe ListView.SelectedListViewItemCollectioné membro do.The Contains method enables you to determine whether an item from the ListView.ListViewItemCollection class is a member of the ListView.SelectedListViewItemCollection. Depois de saber que o item está na coleção, você pode usar o IndexOf método para determinar a posição do item ListView.SelectedListViewItemCollectionno.Once you know that the item is in the collection, you can use the IndexOf method to determine the position of the item in the ListView.SelectedListViewItemCollection.

Construtores

ListView.SelectedListViewItemCollection(ListView)

Inicializa uma nova instância da classe ListView.SelectedListViewItemCollection.Initializes a new instance of the ListView.SelectedListViewItemCollection class.

Propriedades

Count

Obtém o número de itens na coleção.Gets the number of items in the collection.

IsReadOnly

Obtém um valor que indica se a coleção é somente leitura.Gets a value indicating whether the collection is read-only.

Item[Int32]

Obtém o item no índice especificado da coleção.Gets the item at the specified index within the collection.

Item[String]

Obtém um item com a chave especificada da coleção.Gets an item with the specified key from the collection.

Métodos

Clear()

Remove todos os itens da coleção.Removes all items from the collection.

Contains(ListViewItem)

Determina se o item especificado está localizado na coleção.Determines whether the specified item is located in the collection.

ContainsKey(String)

Determina se um item com a chave especificada está contido na coleção.Determines whether an item with the specified key is contained in the collection.

CopyTo(Array, Int32)

Copia toda a coleção em uma matriz existente de um local especificado na matriz.Copies the entire collection into an existing array at a specified location within the array.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetEnumerator()

Retorna um enumerador que pode ser usado para iterar pela coleção de itens selecionada.Returns an enumerator that can be used to iterate through the selected item collection.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IndexOf(ListViewItem)

Retorna o índice na coleção do item especificado.Returns the index within the collection of the specified item.

IndexOfKey(String)

Retorna o índice da primeira ocorrência do item com a chave especificada.Returns the index of the first occurrence of the item with the specified key.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

ICollection.IsSynchronized

Obtém um valor que indica se o acesso à coleção é sincronizado (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread safe).

ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de controels.Gets an object that can be used to synchronize access to the collection of controls.

IList.Add(Object)

Adiciona um item à coleção.Adds an item to the collection.

IList.Contains(Object)

Determina se o item especificado está localizado na coleção.Determines whether the specified item is located in the collection.

IList.IndexOf(Object)

Retorna o índice do item especificado na coleção.Returns the index, within the collection, of the specified item.

IList.Insert(Int32, Object)

Insere um item na coleção em um índice especificado.Inserts an item into the collection at a specified index.

IList.IsFixedSize

Obtém um valor que indica se a coleção tem um tamanho fixo.Gets a value indicating whether the collection has a fixed size.

IList.Item[Int32]

Obtém ou define um objeto da coleção.Gets or sets an object from the collection.

IList.Remove(Object)

Remove a primeira ocorrência de um item especificado da coleção.Removes the first occurrence of a specified item from the collection.

IList.RemoveAt(Int32)

Remove um item da coleção em um índice especificado.Removes an item from the collection at a specified index.

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a