ListView.ListViewItemCollection Classe

Definição

Representa a coleção de itens em um controle ListView ou atribuída a um ListViewGroup.Represents the collection of items in a ListView control or assigned to a ListViewGroup.

public: ref 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
Public Class ListView.ListViewItemCollection
Implements IList
Herança
ListView.ListViewItemCollection
Atributos
Implementações

Exemplos

O exemplo de código a seguir demonstra como adicionar itens a ListView.ListViewItemCollectionum.The following code example demonstrates how to add items to a ListView.ListViewItemCollection. Observe que a Items propriedade de ListView1 é do tipo ListView.ListViewItemCollection.Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. 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 into 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 Load do manipulador de eventos.Call the InitializeListView method from the form's constructor or Load event handler.

// 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.A ListView.ListViewItemCollection stores the items displayed in a ListView control or assigned to a ListViewGroup. Há duas outras coleções definidas dentro da ListView classe que permitem determinar quais itens são selecionados dentro de um ListView controle.There are two other collections defined within the ListView class that enable you to determine what items are selected within a ListView control. 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 ListView.ListViewItemCollection permite que você determine quais índices dentro do de um ListView controle são Selecione.The ListView.SelectedListViewItemCollection class provides properties and methods for determining what items are selected in a ListView control, while the ListView.SelectedIndexCollection class enables you to determine what indexes within the ListView.ListViewItemCollection of a ListView control are selected. 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 ListView do controle é definida como true) dentro dessa coleção.In addition to selection collection classes, there are also two classes that enable you to determine what items are checked (when the CheckBoxes property of the ListView control is set to true) within this collection.

Há várias maneiras de adicionar itens à coleção.There are a number of ways to add items to the collection. O Add método adiciona um único item à coleção.The Add method adds a single item to the collection. Para adicionar um número de itens à coleção, você cria uma matriz de itens e passa-a para o AddRange método.To add a number of items to the collection, you create an array of items and pass it to the AddRange method. Se você quiser inserir um item em um local específico na coleção, poderá usar o Insert método.If you want to insert an item at a specific location in the collection, you can use the Insert method. 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.To remove items, you can use either the Remove method or the RemoveAt method if you know where the item is located in the collection. O Clear método permite remover todos os itens da coleção, em vez de usar o Remove método para remover um único item de cada vez.The Clear method enables you to remove all items from the collection instead of using the Remove method to remove a single item at a time.

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.In addition to methods and properties for adding and removing items, the ListView.ListViewItemCollection also provides methods to find items in the collection. O Contains método permite que você determine se um item é um membro da coleção.The Contains method enables you to determine whether an item is a member of the collection. 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.Once you know that the item is located in the collection, you can use the IndexOf method to determine where the item is located in the collection.

Construtores

ListView.ListViewItemCollection(ListView)

Inicializa uma nova instância da classe ListView.ListViewItemCollection.Initializes a new instance of the ListView.ListViewItemCollection 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 ou define o item no índice especificado da coleção.Gets or sets the item at the specified index within the collection.

Item[String]

Recupera o item com a chave especificada.Retrieves the item with the specified key.

Métodos

Add(ListViewItem)

Adiciona um ListViewItem existente à coleção.Adds an existing ListViewItem to the collection.

Add(String)

Cria um item com o texto especificado e o adiciona à coleção.Creates an item with the specified text and adds it to the collection.

Add(String, Int32)

Cria um item com o texto e imagem especificados e o adiciona à coleção.Creates an item with the specified text and image and adds it to the collection.

Add(String, String)

Cria um item com o texto e imagem especificados e o adiciona à coleção.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32)

Cria um item com a chave, o texto e a imagem especificados e adiciona um item à coleção.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String)

Cria um item com a chave, o texto e a imagem especificados e o adiciona à coleção.Creates an item with the specified key, text, and image, and adds it to the collection.

AddRange(ListView+ListViewItemCollection)

Adiciona uma coleção de itens à coleção.Adds a collection of items to the collection.

AddRange(ListViewItem[])

Adiciona uma matriz de objetos ListViewItem à coleção.Adds an array of ListViewItem objects to the collection.

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 a coleção contém um item com a chave especificada.Determines whether the collection contains an item with the specified key.

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)
Find(String, Boolean)

Pesquisa itens cujo nome corresponde à chave especificada e, opcionalmente, também pesquisa subitens.Searches for items whose name matches the specified key, optionally searching subitems.

GetEnumerator()

Retorna um enumerador a ser usado para iterar pela coleção de itens.Returns an enumerator to use to iterate through the 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)

Recupera o índice do item com a chave especificada.Retrieves the index of the item with the specified key.

Insert(Int32, ListViewItem)

Insere um ListViewItem existente na coleção no índice especificado.Inserts an existing ListViewItem into the collection at the specified index.

Insert(Int32, String)

Cria um novo item e o insere na coleção no índice especificado.Creates a new item and inserts it into the collection at the specified index.

Insert(Int32, String, Int32)

Cria um novo item com o índice de imagem especificado e o insere na coleção, no índice especificado.Creates a new item with the specified image index and inserts it into the collection at the specified index.

Insert(Int32, String, String)

Cria um novo item com a imagem e o texto especificados e o insere na coleção, no índice especificado.Creates a new item with the specified text and image and inserts it in the collection at the specified index.

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.Creates a new item with the specified key, text, and image, and inserts it in the collection at the specified index.

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.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

MemberwiseClone()

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

(Herdado de Object)
Remove(ListViewItem)

Remove o item especificado da coleção.Removes the specified item from the collection.

RemoveAt(Int32)

Remove o item no índice especificado da coleção.Removes the item at the specified index within the collection.

RemoveByKey(String)

Remove o item com a chave especificada da coleção.Removes the item with the specified key from the collection.

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 objeto existente à coleção.Adds an existing object to the collection.

IList.Contains(Object)

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

IList.IndexOf(Object)

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

IList.Insert(Int32, Object)

Insere um objeto na coleção no índice especificado.Inserts an object into the collection at the 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 o ListViewItem no índice especificado na coleção.Gets or sets the ListViewItem at the specified index within the collection.

IList.Remove(Object)

Remove o item especificado da coleção.Removes the specified item from the collection.

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

Veja também