ListView.ListViewItemCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa a coleção de itens em um controle ListView ou atribuída a um ListViewGroup.

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

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

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

Public Class ListView.ListViewItemCollection
Implements IList

Herança

Object

ListView.ListViewItemCollection

Atributos

ListBindableAttribute

Implementações

ICollection IEnumerable IList

Exemplos

O exemplo de código a seguir demonstra como adicionar itens a um ListView.ListViewItemCollection. Observe que a Items propriedade de ListView1 é do tipo ListView.ListViewItemCollection. 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 ou Load manipulador de eventos do formulário.

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

Comentários

Um ListView.ListViewItemCollection armazena os itens exibidos em um ListView controle ou atribuídos a um ListViewGroup. Há duas outras coleções definidas dentro da ListView classe que permitem determinar quais itens são selecionados dentro de um ListView controle. A ListView.SelectedListViewItemCollection classe fornece propriedades e métodos para determinar quais itens são selecionados em um ListView controle, enquanto a ListView.SelectedIndexCollection classe permite que você determine quais índices dentro de ListView.ListViewItemCollection um ListView controle são selecionados. Além das classes de coleção de seleção, também há duas classes que permitem determinar quais itens são verificados (quando a CheckBoxes propriedade do ListView controle é definida truecomo ) dentro dessa coleção.

Há várias maneiras de adicionar itens à coleção. O Add método adiciona um único item à coleção. Para adicionar vários itens à coleção, crie uma matriz de itens e passe-a para o AddRange método . Se você quiser inserir um item em um local específico na coleção, poderá usar o Insert método . Para remover itens, você pode usar o Remove método ou o RemoveAt método se souber onde o item está localizado na coleção. O Clear método permite que você remova todos os itens da coleção em vez de usar o Remove método para remover um único item de cada vez.

Além de métodos e propriedades para adicionar e remover itens, o ListView.ListViewItemCollection também fornece métodos para localizar itens na coleção. O Contains método permite que você determine se um item é um membro da coleção. Depois de saber que o item está localizado na coleção, você pode usar o IndexOf método para determinar onde o item está localizado na coleção.

Construtores

ListView.ListViewItemCollection(ListView)

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

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 ou define o item no índice especificado da coleção.
Item[String]	Recupera o item com a chave especificada.

Métodos

Add(ListViewItem)	Adiciona um ListViewItem existente à coleção.
Add(String)	Cria um item com o texto especificado e o adiciona à coleção.
Add(String, Int32)	Cria um item com o texto e imagem especificados e o adiciona à coleção.
Add(String, String)	Cria um item com o texto e imagem especificados e o adiciona à coleção.
Add(String, String, Int32)	Cria um item com a chave, o texto e a imagem especificados e adiciona um item à coleção.
Add(String, String, String)	Cria um item com a chave, o texto e a imagem especificados e o adiciona à coleção.
AddRange(ListView+ListViewItemCollection)	Adiciona uma coleção de itens à coleção.
AddRange(ListViewItem[])	Adiciona uma matriz de objetos ListViewItem à coleção.
Clear()	Remove todos os itens da coleção.
Contains(ListViewItem)	Determina se o item especificado está localizado na coleção.
ContainsKey(String)	Determina se a coleção contém um item com a chave especificada.
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)
Find(String, Boolean)	Pesquisa itens cujo nome corresponde à chave especificada e, opcionalmente, também pesquisa subitens.
GetEnumerator()	Retorna um enumerador a ser usado para iterar pela coleção de itens.
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)	Recupera o índice do item com a chave especificada.
Insert(Int32, ListViewItem)	Insere um ListViewItem existente na coleção no índice especificado.
Insert(Int32, String)	Cria um novo item e o insere na coleção no índice especificado.
Insert(Int32, String, Int32)	Cria um novo item com o índice de imagem especificado e o insere na coleção, no índice especificado.
Insert(Int32, String, String)	Cria um novo item com a imagem e o texto especificados e o insere na coleção, no índice especificado.
Insert(Int32, String, String, Int32)	Cria um novo item com a chave, a imagem e o texto especificados e o insere na coleção, no índice especificado.
Insert(Int32, String, String, String)	Cria um novo item com a chave, a imagem e o texto especificados e o adiciona à coleção, no índice especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(ListViewItem)	Remove o item especificado da coleção.
RemoveAt(Int32)	Remove o item no índice especificado da coleção.
RemoveByKey(String)	Remove o item com a chave especificada da coleção.
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 objeto existente à coleção.
IList.Contains(Object)	Determina se o item especificado está na coleção.
IList.IndexOf(Object)	Retorna o índice na coleção do item especificado.
IList.Insert(Int32, Object)	Insere um objeto na coleção no í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 o ListViewItem no índice especificado na coleção.
IList.Remove(Object)	Remove o item especificado da coleção.

Métodos de Extensão

Confira também

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection