ListView.ListViewItemCollection Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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

Herencia

Object

ListView.ListViewItemCollection

Atributos

ListBindableAttribute

Implementaciones

ICollection IEnumerable IList

Ejemplos

En el ejemplo de código siguiente se muestra cómo agregar elementos a .ListView.ListViewItemCollection Tenga en cuenta que la Items propiedad de ListView1 es de tipo ListView.ListViewItemCollection. Para ejecutar este ejemplo, pegue el código siguiente en un formulario que contenga un ListView objeto denominado ListView1 y un TextBox denominado TextBox1. Llame al InitializeListView método desde el constructor o Load controlador de eventos del formulario.

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

ListView.ListViewItemCollection Almacena los elementos mostrados en un ListView control o asignados a .ListViewGroup Hay otras dos colecciones definidas dentro de la ListView clase que permiten determinar qué elementos se seleccionan dentro de un ListView control. La ListView.SelectedListViewItemCollection clase proporciona propiedades y métodos para determinar qué elementos se seleccionan en un ListView control, mientras que la ListView.SelectedIndexCollection clase permite determinar qué índices de ListView.ListViewItemCollection un ListView control se seleccionan. Además de las clases de colección de selección, también hay dos clases que permiten determinar qué elementos se comprueban (cuando la CheckBoxes propiedad del ListView control se establece trueen ) dentro de esta colección.

Hay varias maneras de agregar elementos a la colección. El Add método agrega un solo elemento a la colección. Para agregar una serie de elementos a la colección, cree una matriz de elementos y pásela al AddRange método . Si desea insertar un elemento en una ubicación específica de la colección, puede usar el Insert método . Para quitar elementos, puede usar el Remove método o el RemoveAt método si sabe dónde se encuentra el elemento en la colección. El Clear método permite quitar todos los elementos de la colección en lugar de usar el Remove método para quitar un solo elemento a la vez.

Además de métodos y propiedades para agregar y quitar elementos, ListView.ListViewItemCollection también proporciona métodos para buscar elementos en la colección. El Contains método permite determinar si un elemento es miembro de la colección. Una vez que sepa que el elemento se encuentra en la colección, puede usar el IndexOf método para determinar dónde se encuentra el elemento en la colección.

Constructores

ListView.ListViewItemCollection(ListView)

Inicializa una nueva instancia de la clase ListView.ListViewItemCollection.

Propiedades

Count	Obtiene el número de elementos de la colección.
IsReadOnly	Obtiene un valor que indica si la colección es de solo lectura.
Item[Int32]	Obtiene o establece el elemento en el índice especificado de la colección.
Item[String]	Recupera el elemento con la clave especificada.

Métodos

Add(ListViewItem)	Agrega un objeto ListViewItem existente a la colección.
Add(String)	Crea un elemento con el texto especificado y lo agrega a la colección.
Add(String, Int32)	Crea un elemento con la imagen y el texto especificados y lo agrega a la colección.
Add(String, String)	Crea un elemento con la imagen y el texto especificados y lo agrega a la colección.
Add(String, String, Int32)	Crea un elemento con el texto, la clave y la imagen especificadas y lo agrega a la colección.
Add(String, String, String)	Crea un elemento con el texto, la clave y la imagen especificados y lo agrega a la colección.
AddRange(ListView+ListViewItemCollection)	Agrega una colección de elementos a la colección.
AddRange(ListViewItem[])	Agrega una matriz de objetos ListViewItem a la colección.
Clear()	Quita todos los elementos de la colección.
Contains(ListViewItem)	Determina si el elemento especificado se encuentra en la colección.
ContainsKey(String)	Determina si la colección contiene un elemento con la clave especificada.
CopyTo(Array, Int32)	Copia toda la colección en una matriz existente, en un lugar especificado de la matriz.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Find(String, Boolean)	Busca elementos cuyo nombre coincida con la clave especificada y, opcionalmente, subelementos.
GetEnumerator()	Devuelve un enumerador que se va a utilizar para recorrer en iteración la colección de elementos.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(ListViewItem)	Devuelve el índice del elemento especificado en la colección.
IndexOfKey(String)	Recupera el índice del elemento con la clave especificada.
Insert(Int32, ListViewItem)	Inserta un ListViewItem existente en el índice especificado de la colección.
Insert(Int32, String)	Crea un nuevo elemento y lo inserta en la colección, en el índice especificado.
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.
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.
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.
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.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(ListViewItem)	Quita el elemento especificado de la colección.
RemoveAt(Int32)	Quita el elemento en el índice especificado de la colección.
RemoveByKey(String)	Quita de la colección el elemento con la clave especificada.
ToString()	Devuelve una cadena que representa el objeto actual. (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).
ICollection.SyncRoot	Obtiene un objeto que puede utilizarse para sincronizar el acceso a la colección de controles.
IList.Add(Object)	Agrega un objeto existente a la colección.
IList.Contains(Object)	Determina si el elemento especificado se encuentra en la colección.
IList.IndexOf(Object)	Devuelve el índice del elemento especificado en la colección.
IList.Insert(Int32, Object)	Inserta un objeto en el índice especificado de la colección.
IList.IsFixedSize	Obtiene un valor que indica si la colección tiene un tamaño fijo.
IList.Item[Int32]	Obtiene o establece el objeto ListViewItem en el índice especificado de la colección.
IList.Remove(Object)	Quita el elemento especificado de la colección.

Métodos de extensión

Consulte también

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection