ListView.SelectedListViewItemCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa a coleção de itens selecionados em um controle de exibição de lista.

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

Herança

Object

ListView.SelectedListViewItemCollection

Atributos

ListBindableAttribute

Implementações

ICollection IEnumerable IList

Exemplos

O exemplo de código a seguir demonstra o uso do SelectedItems, SelectedIndexChanged evento e membros e HeaderStyle a ListView.SelectedListViewItemCollection classe . Para executar este exemplo, cole o código a seguir em um formulário que contém um ListView objeto chamado ListView1 e um TextBox chamado TextBox1. Chame o InitializeListView método do construtor do formulário ou do Load manipulador de eventos. Este exemplo exige que o manipulador de eventos esteja corretamente associado ao SelectedIndexChanged evento

// 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 . Os itens armazenados no ListView.SelectedListViewItemCollection são itens contidos no ListView.ListViewItemCollection. O ListView.ListViewItemCollection armazena todos os itens exibidos no ListView.

A tabela a seguir mostra um exemplo de como o ListView.ListViewItemCollection armazena os itens do ListView , bem como seus estados de seleção em um controle de exemplo ListView .

Índice	Item	Estado de seleção no ListView
0	Item1	Não selecionado
1	Item2	Selecionada
2	Item3	Não selecionado
3	Item4	Selecionada
4	Item5	Selecionada

Com base no ListView.ListViewItemCollection exemplo na tabela anterior, a tabela a seguir demonstra como o ListView.SelectedListViewItemCollection seria exibido.

Índice	Item selecionado no ListViewItemCollection
0	Item2
1	Item4
2	Item5

Você pode usar as propriedades e os métodos dessa classe para executar uma variedade de tarefas com a coleção. O Contains método permite determinar se um item da ListView.ListViewItemCollection classe é um membro do 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 no ListView.SelectedListViewItemCollection.

Construtores

ListView.SelectedListViewItemCollection(ListView)

Inicializa uma nova instância da classe ListView.SelectedListViewItemCollection.

Propriedades

Count	Obtém o número de itens na coleção.
IsReadOnly	Obtém um valor que indica se a coleção é somente leitura.
Item[Int32]	Obtém o item no índice especificado da coleção.
Item[String]	Obtém um item com a chave especificada da coleção.

Métodos

Clear()	Remove todos os itens da coleção.
Contains(ListViewItem)	Determina se o item especificado está localizado na coleção.
ContainsKey(String)	Determina se um item com a chave especificada está contido na coleção.
CopyTo(Array, Int32)	Copia toda a coleção em uma matriz existente de um local especificado na matriz.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que pode ser usado para iterar pela coleção de itens selecionada.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(ListViewItem)	Retorna o índice na coleção do item especificado.
IndexOfKey(String)	Retorna o índice da primeira ocorrência do item com a chave especificada.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (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).
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de controels.
IList.Add(Object)	Adiciona um item à coleção.
IList.Contains(Object)	Determina se o item especificado está localizado na coleção.
IList.IndexOf(Object)	Retorna o índice do item especificado na coleção.
IList.Insert(Int32, Object)	Insere um item na coleção em um índice especificado.
IList.IsFixedSize	Obtém um valor que indica se a coleção tem um tamanho fixo.
IList.Item[Int32]	Obtém ou define um objeto da coleção.
IList.Remove(Object)	Remove a primeira ocorrência de um item especificado da coleção.
IList.RemoveAt(Int32)	Remove um item da coleção em um índice especificado.

Métodos de Extensão