ListView.ListViewItemCollection Clase

Definición

Representa la colección de elementos en un control ListView o asignados a 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
Herencia
ListView.ListViewItemCollection
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo agregar elementos ListView.ListViewItemCollectiona un.The following code example demonstrates how to add items to a ListView.ListViewItemCollection. Tenga en cuenta Items que la ListView1 propiedad de es ListView.ListViewItemCollectionde tipo.Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. Para ejecutar este ejemplo, pegue el código siguiente en un formulario que contenga ListView un objeto ListView1 denominado y TextBox un TextBox1denominado.To run this example, paste the following code into a form that contains a ListView object named ListView1 and a TextBox named TextBox1. Llame al InitializeListView método desde el constructor del formulario o Load el controlador 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

Comentarios

Un ListView.ListViewItemCollection almacena los elementos mostrados en ListView un control o asignados ListViewGroupa un.A ListView.ListViewItemCollection stores the items displayed in a ListView control or assigned to a ListViewGroup. Hay otras dos colecciones definidas dentro de la ListView clase que permiten determinar qué elementos se seleccionan dentro de un ListView control.There are two other collections defined within the ListView class that enable you to determine what items are selected within a ListView control. La ListView.SelectedListViewItemCollection clase proporciona propiedades y métodos para determinar qué elementos están seleccionados en un ListView control, mientras que ListView.SelectedIndexCollection la clase permite determinar qué índices dentro ListView.ListViewItemCollection de un ListView control son seleccionadas.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. Además de las clases de colección de selección, también hay dos clases que le permiten determinar qué elementos se comprueban ( CheckBoxes cuando la propiedad ListView del control se establece trueen) dentro de esta colección.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.

Hay varias maneras de agregar elementos a la colección.There are a number of ways to add items to the collection. El Add método agrega un elemento único a la colección.The Add method adds a single item to the collection. Para agregar un número de elementos a la colección, cree una matriz de elementos y páselo al 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. Si desea insertar un elemento en una ubicación específica de la colección, puede utilizar el Insert método.If you want to insert an item at a specific location in the collection, you can use the Insert method. Para quitar elementos, puede utilizar el Remove método o el RemoveAt método si sabe dónde se encuentra el elemento en la colección.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. El Clear método permite quitar todos los elementos de la colección en lugar de utilizar el Remove método para quitar un solo elemento 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.

Además de los métodos y las propiedades para agregar y quitar elementos, ListView.ListViewItemCollection también proporciona métodos para buscar elementos en la colección.In addition to methods and properties for adding and removing items, the ListView.ListViewItemCollection also provides methods to find items in the collection. El Contains método le permite determinar si un elemento es miembro de la colección.The Contains method enables you to determine whether an item is a member of the collection. Una vez que sepa que el elemento se encuentra en la colección, puede utilizar el IndexOf método para determinar dónde se encuentra el elemento en la colección.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.

Constructores

ListView.ListViewItemCollection(ListView)

Inicializa una nueva instancia de la clase ListView.ListViewItemCollection.Initializes a new instance of the ListView.ListViewItemCollection class.

Propiedades

Count

Obtiene el número de elementos de la colección.Gets the number of items in the collection.

IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.Gets a value indicating whether the collection is read-only.

Item[Int32]

Obtiene o establece el elemento en el índice especificado de la colección.Gets or sets the item at the specified index within the collection.

Item[String]

Recupera el elemento con la clave especificada.Retrieves the item with the specified key.

Métodos

Add(ListViewItem)

Agrega un objeto ListViewItem existente a la colección.Adds an existing ListViewItem to the collection.

Add(String)

Crea un elemento con el texto especificado y lo agrega a la colección.Creates an item with the specified text and adds it to the collection.

Add(String, Int32)

Crea un elemento con la imagen y el texto especificados y lo agrega a la colección.Creates an item with the specified text and image and adds it to the collection.

Add(String, String)

Crea un elemento con la imagen y el texto especificados y lo agrega a la colección.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32)

Crea un elemento con el texto, la clave y la imagen especificadas y lo agrega a la colección.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String)

Crea un elemento con el texto, la clave y la imagen especificados y lo agrega a la colección.Creates an item with the specified key, text, and image, and adds it to the collection.

AddRange(ListView+ListViewItemCollection)

Agrega una colección de elementos a la colección.Adds a collection of items to the collection.

AddRange(ListViewItem[])

Agrega una matriz de objetos ListViewItem a la colección.Adds an array of ListViewItem objects to the collection.

Clear()

Quita todos los elementos de la colección.Removes all items from the collection.

Contains(ListViewItem)

Determina si el elemento especificado se encuentra en la colección.Determines whether the specified item is located in the collection.

ContainsKey(String)

Determina si la colección contiene un elemento con la clave especificada.Determines whether the collection contains an item with the specified key.

CopyTo(Array, Int32)

Copia toda la colección en una matriz existente, en un lugar especificado de la matriz.Copies the entire collection into an existing array at a specified location within the array.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
Find(String, Boolean)

Busca elementos cuyo nombre coincida con la clave especificada y, opcionalmente, subelementos.Searches for items whose name matches the specified key, optionally searching subitems.

GetEnumerator()

Devuelve un enumerador que se va a utilizar para recorrer en iteración la colección de elementos.Returns an enumerator to use to iterate through the item collection.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IndexOf(ListViewItem)

Devuelve el índice del elemento especificado en la colección.Returns the index within the collection of the specified item.

IndexOfKey(String)

Recupera el índice del elemento con la clave especificada.Retrieves the index of the item with the specified key.

Insert(Int32, ListViewItem)

Inserta un ListViewItem existente en el índice especificado de la colección.Inserts an existing ListViewItem into the collection at the specified index.

Insert(Int32, String)

Crea un nuevo elemento y lo inserta en la colección, en el índice especificado.Creates a new item and inserts it into the collection at the specified index.

Insert(Int32, String, Int32)

Crea un nuevo elemento con el índice de imágenes especificado y lo inserta en la colección, en el í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)

Crea un nuevo elemento con la imagen y el texto especificados y lo inserta en la colección, en el í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)

Crea un nuevo elemento con el texto, la imagen y la clave especificadas y lo inserta en la colección, en el í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)

Crea un nuevo elemento con el texto, la imagen y la clave especificadas y lo agrega a la colección, en el índice especificado.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
Remove(ListViewItem)

Quita el elemento especificado de la colección.Removes the specified item from the collection.

RemoveAt(Int32)

Quita el elemento en el índice especificado de la colección.Removes the item at the specified index within the collection.

RemoveByKey(String)

Quita de la colección el elemento con la clave especificada.Removes the item with the specified key from the collection.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.IsSynchronized

Obtiene un valor que indica si el acceso a la colección está sincronizado (es seguro para la ejecución de subprocesos).Gets a value indicating whether access to the collection is synchronized (thread safe).

ICollection.SyncRoot

Obtiene un objeto que puede utilizarse para sincronizar el acceso a la colección de controles.Gets an object that can be used to synchronize access to the collection of controls.

IList.Add(Object)

Agrega un objeto existente a la colección.Adds an existing object to the collection.

IList.Contains(Object)

Determina si el elemento especificado se encuentra en la colección.Determines whether the specified item is in the collection.

IList.IndexOf(Object)

Devuelve el índice del elemento especificado en la colección.Returns the index within the collection of the specified item.

IList.Insert(Int32, Object)

Inserta un objeto en el índice especificado de la colección.Inserts an object into the collection at the specified index.

IList.IsFixedSize

Obtiene un valor que indica si la colección tiene un tamaño fijo.Gets a value indicating whether the collection has a fixed size.

IList.Item[Int32]

Obtiene o establece el objeto ListViewItem en el índice especificado de la colección.Gets or sets the ListViewItem at the specified index within the collection.

IList.Remove(Object)

Quita el elemento especificado de la colección.Removes the specified item from the collection.

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: