ListViewItem Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un elemento en un control ListView.

public ref class ListViewItem : ICloneable, System::Runtime::Serialization::ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))]
[System.Serializable]
public class ListViewItem : ICloneable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))>]
[<System.Serializable>]
type ListViewItem = class
    interface ICloneable
    interface ISerializable

Public Class ListViewItem
Implements ICloneable, ISerializable

Herencia: Object
ListViewItem

Atributos: TypeConverterAttribute SerializableAttribute

Implementaciones: ICloneable ISerializable

Ejemplos

En el ejemplo de código siguiente se crea un ListView control con tres ListViewItem objetos especificados y tres ListViewItem.ListViewSubItem objetos especificados para cada elemento. En el ejemplo también se crean ColumnHeader objetos para mostrar los subelementos en la vista de detalles. También se crean dos ImageList objetos en el ejemplo de código para proporcionar imágenes para los ListViewItem objetos . Estos ImageList objetos se agregan a las LargeImageList propiedades y SmallImageList . En el ejemplo se usan las siguientes propiedades para crear el ListView control:

Debe agregar el código a Form y llamar al método creado en el ejemplo desde el constructor u otro método del formulario. El ejemplo requiere que las imágenes denominadas MySmallImage1, MySmallImage2, MyLargeImage1y MyLargeImage2 se encuentren en el directorio raíz de la unidad C.

private:
   void CreateMyListView()
   {
      // Create a new ListView control.
      ListView^ listView1 = gcnew ListView;
      listView1->Bounds = Rectangle(Point(10,10),System::Drawing::Size( 300, 200 ));

      // Set the view to show details.
      listView1->View = View::Details;

      // Allow the user to edit item text.
      listView1->LabelEdit = true;

      // Allow the user to rearrange columns.
      listView1->AllowColumnReorder = true;

      // Display check boxes.
      listView1->CheckBoxes = true;

      // Select the item and subitems when selection is made.
      listView1->FullRowSelect = true;

      // Display grid lines.
      listView1->GridLines = true;

      // Sort the items in the list in ascending order.
      listView1->Sorting = SortOrder::Ascending;

      // Create three items and three sets of subitems for each item.
      ListViewItem^ item1 = gcnew ListViewItem( "item1",0 );

      // Place a check mark next to the item.
      item1->Checked = true;
      item1->SubItems->Add( "1" );
      item1->SubItems->Add( "2" );
      item1->SubItems->Add( "3" );
      ListViewItem^ item2 = gcnew ListViewItem( "item2",1 );
      item2->SubItems->Add( "4" );
      item2->SubItems->Add( "5" );
      item2->SubItems->Add( "6" );
      ListViewItem^ item3 = gcnew ListViewItem( "item3",0 );

      // Place a check mark next to the item.
      item3->Checked = true;
      item3->SubItems->Add( "7" );
      item3->SubItems->Add( "8" );
      item3->SubItems->Add( "9" );

      // Create columns for the items and subitems.
      // Width of -2 indicates auto-size.
      listView1->Columns->Add( "Item Column", -2, HorizontalAlignment::Left );
      listView1->Columns->Add( "Column 2", -2, HorizontalAlignment::Left );
      listView1->Columns->Add( "Column 3", -2, HorizontalAlignment::Left );
      listView1->Columns->Add( "Column 4", -2, HorizontalAlignment::Center );

      //Add the items to the ListView.
      array<ListViewItem^>^temp1 = {item1,item2,item3};
      listView1->Items->AddRange( temp1 );

      // Create two ImageList objects.
      ImageList^ imageListSmall = gcnew ImageList;
      ImageList^ imageListLarge = gcnew ImageList;

      // Initialize the ImageList objects with bitmaps.
      imageListSmall->Images->Add( Bitmap::FromFile( "C:\\MySmallImage1.bmp" ) );
      imageListSmall->Images->Add( Bitmap::FromFile( "C:\\MySmallImage2.bmp" ) );
      imageListLarge->Images->Add( Bitmap::FromFile( "C:\\MyLargeImage1.bmp" ) );
      imageListLarge->Images->Add( Bitmap::FromFile( "C:\\MyLargeImage2.bmp" ) );

      //Assign the ImageList objects to the ListView.
      listView1->LargeImageList = imageListLarge;
      listView1->SmallImageList = imageListSmall;
      
      // Add the ListView to the control collection.
      this->Controls->Add( listView1 );
   }

private void CreateMyListView()
{
    // Create a new ListView control.
    ListView listView1 = new ListView();
    listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

    // Set the view to show details.
    listView1.View = View.Details;
    // Allow the user to edit item text.
    listView1.LabelEdit = true;
    // Allow the user to rearrange columns.
    listView1.AllowColumnReorder = true;
    // Display check boxes.
    listView1.CheckBoxes = true;
    // Select the item and subitems when selection is made.
    listView1.FullRowSelect = true;
    // Display grid lines.
    listView1.GridLines = true;
    // Sort the items in the list in ascending order.
    listView1.Sorting = SortOrder.Ascending;
                
    // Create three items and three sets of subitems for each item.
    ListViewItem item1 = new ListViewItem("item1",0);
    // Place a check mark next to the item.
    item1.Checked = true;
    item1.SubItems.Add("1");
    item1.SubItems.Add("2");
    item1.SubItems.Add("3");
    ListViewItem item2 = new ListViewItem("item2",1);
    item2.SubItems.Add("4");
    item2.SubItems.Add("5");
    item2.SubItems.Add("6");
    ListViewItem item3 = new ListViewItem("item3",0);
    // Place a check mark next to the item.
    item3.Checked = true;
    item3.SubItems.Add("7");
    item3.SubItems.Add("8");
    item3.SubItems.Add("9");

    // Create columns for the items and subitems.
    // Width of -2 indicates auto-size.
    listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

    //Add the items to the ListView.
    listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

    // Create two ImageList objects.
    ImageList imageListSmall = new ImageList();
    ImageList imageListLarge = new ImageList();

    // Initialize the ImageList objects with bitmaps.
    imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
    imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
    imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
    imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

    //Assign the ImageList objects to the ListView.
    listView1.LargeImageList = imageListLarge;
    listView1.SmallImageList = imageListSmall;

    // Add the ListView to the control collection.
    this.Controls.Add(listView1);
}

Private Sub CreateMyListView()
    ' Create a new ListView control.
    Dim listView1 As New ListView()
    listView1.Bounds = New Rectangle(New Point(10, 10), New Size(300, 200))

    ' Set the view to show details.
    listView1.View = View.Details
    ' Allow the user to edit item text.
    listView1.LabelEdit = True
    ' Allow the user to rearrange columns.
    listView1.AllowColumnReorder = True
    ' Display check boxes.
    listView1.CheckBoxes = True
    ' Select the item and subitems when selection is made.
    listView1.FullRowSelect = True
    ' Display grid lines.
    listView1.GridLines = True
    ' Sort the items in the list in ascending order.
    listView1.Sorting = SortOrder.Ascending

    ' Create three items and three sets of subitems for each item.
    Dim item1 As New ListViewItem("item1", 0)
    ' Place a check mark next to the item.
    item1.Checked = True
    item1.SubItems.Add("1")
    item1.SubItems.Add("2")
    item1.SubItems.Add("3")
    Dim item2 As New ListViewItem("item2", 1)
    item2.SubItems.Add("4")
    item2.SubItems.Add("5")
    item2.SubItems.Add("6")
    Dim item3 As New ListViewItem("item3", 0)
    ' Place a check mark next to the item.
    item3.Checked = True
    item3.SubItems.Add("7")
    item3.SubItems.Add("8")
    item3.SubItems.Add("9")

    ' Create columns for the items and subitems.
    ' Width of -2 indicates auto-size.
    listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left)
    listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left)
    listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left)
    listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center)

    'Add the items to the ListView.
    listView1.Items.AddRange(New ListViewItem() {item1, item2, item3})

    ' Create two ImageList objects.
    Dim imageListSmall As New ImageList()
    Dim imageListLarge As New ImageList()

    ' Initialize the ImageList objects with bitmaps.
    imageListSmall.Images.Add(Bitmap.FromFile("C:\MySmallImage1.bmp"))
    imageListSmall.Images.Add(Bitmap.FromFile("C:\MySmallImage2.bmp"))
    imageListLarge.Images.Add(Bitmap.FromFile("C:\MyLargeImage1.bmp"))
    imageListLarge.Images.Add(Bitmap.FromFile("C:\MyLargeImage2.bmp"))

    'Assign the ImageList objects to the ListView.
    listView1.LargeImageList = imageListLarge
    listView1.SmallImageList = imageListSmall

    ' Add the ListView to the control collection.
    Me.Controls.Add(listView1)
End Sub

Comentarios

El ListView control es similar a un ListBox elemento en el que muestra una lista de elementos. La principal diferencia es que el ListView control proporciona una serie de diferentes formas en que el usuario puede ver los elementos. La ListViewItem clase define la apariencia, el comportamiento y los datos asociados a un elemento que se muestra en el ListView control . ListViewItem Los objetos se pueden mostrar en el ListView control en una de las cuatro vistas diferentes. Los elementos se pueden mostrar como iconos grandes o pequeños o como iconos pequeños en una lista vertical. Los elementos también pueden tener subelementos que contienen información relacionada con el elemento primario. El cuarto estilo de vista, vista de detalles, permite mostrar el elemento y sus subelementos en una cuadrícula con encabezados de columna que se pueden usar para identificar la información que se muestra en un subelemento.

La mayoría de las propiedades de la ListViewItem clase proporcionan formas de cambiar la presentación del elemento en el ListView control al que está asociado. Las BackColorpropiedades , ForeColory Font permiten cambiar cómo se muestra el texto del elemento en el ListView control . La ImageIndex propiedad permite especificar la imagen que se va a cargar desde el ImageList que se asigna al ListView control (estableciendo las LargeImageList propiedades o SmallImageList de ListView). Los elementos pueden mostrar casillas para obtener opciones de elemento del usuario de una manera similar a un CheckedListBox control. Puede usar la Checked propiedad para determinar si un elemento está activado o para activar o desactivar la casilla en tiempo de ejecución. Los elementos pueden mostrar cualquier número de subelementos cuando la View propiedad del control asociado ListView se establece Details en y las columnas se definen en el ListView.ColumnHeaderCollection ListView del control . Puede agregar subelementos a un elemento llamando al Add método de la ListViewItem.ListViewSubItemCollection clase . La SubItems propiedad permite obtener acceso a la ListViewItem.ListViewSubItemCollection clase y a sus miembros.

Algunas de las propiedades y métodos de la ListViewItem clase son versiones específicas del elemento de propiedades y métodos del ListView control. Por ejemplo, el EnsureVisible método es similar a la ListView versión del método , pero la ListViewItem versión afecta solo al elemento actual.

La ListViewItem clase también proporciona métodos que no son versiones de ListView métodos. El BeginEdit método coloca el texto del elemento en modo de edición para que el usuario pueda cambiar el texto del elemento (cuando la LabelEdit propiedad del ListView control se establece trueen ). El Clone método permite crear copias de objetos existentes ListViewItem para reutilizarlos en otros ListView controles.

Constructores

ListViewItem()	Inicializa una nueva instancia de la clase ListViewItem con valores predeterminados.
ListViewItem(ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem y la asigna al grupo especificado.
ListViewItem(ListViewItem+ListViewSubItem[], Int32)	Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento y una matriz de objetos ListViewItem.ListViewSubItem.
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento y una matriz de objetos ListViewItem.ListViewSubItem y asigna el elemento al grupo especificado.
ListViewItem(ListViewItem+ListViewSubItem[], String)	Inicializa una nueva instancia de la clase ListViewItem con la imagen y los subelementos especificados.
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con la imagen, el grupo y los subelementos especificados.
ListViewItem(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la clase ListViewItem con la información de serialización y el contexto de transmisión de secuencias especificados.
ListViewItem(String)	Inicializa una nueva instancia de la clase ListViewItem con el texto especificado.
ListViewItem(String, Int32)	Inicializa una nueva instancia de la clase ListViewItem con el texto del elemento especificado y la posición de índice de la imagen del icono del elemento.
ListViewItem(String, Int32, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con el texto del elemento especificado y la posición de índice de la imagen del icono del elemento, y asigna el elemento al grupo especificado.
ListViewItem(String, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con el texto del elemento especificado y la asigna al grupo especificado.
ListViewItem(String, String)	Inicializa una nueva instancia de la clase ListViewItem con la imagen y el texto especificados.
ListViewItem(String, String, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con la imagen, el grupo y los subelementos especificados.
ListViewItem(String[])	Inicializa una nueva instancia de la clase ListViewItem con una matriz de cadenas que representan subelementos.
ListViewItem(String[], Int32)	Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento y una matriz de cadenas que representan los subelementos.
ListViewItem(String[], Int32, Color, Color, Font)	Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento, el color de primer plano, el color de fondo y la fuente del elemento; y una matriz de cadenas que representan los subelementos.
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento, el color de primer plano, el color de fondo y la fuente del elemento; y una matriz de cadenas que representan los subelementos. Asigna el elemento al grupo especificado.
ListViewItem(String[], Int32, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento y una matriz de cadenas que representan los subelementos, y asigna el elemento al grupo especificado.
ListViewItem(String[], ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con una matriz de cadenas que representan los subelementos y asigna el elemento al grupo especificado.
ListViewItem(String[], String)	Inicializa una nueva instancia de la clase ListViewItem con el texto y la imagen del elemento y el subelemento especificados.
ListViewItem(String[], String, Color, Color, Font)	Inicializa una nueva instancia de la clase ListViewItem con los subelementos que contienen el texto, imagen, colores y fuente especificados.
ListViewItem(String[], String, Color, Color, Font, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con los subelementos que contienen el texto, imagen, colores, fuente y grupo especificados.
ListViewItem(String[], String, ListViewGroup)	Inicializa una nueva instancia de la clase ListViewItem con subelementos que contienen el texto, la imagen y el grupo especificados.

Propiedades

BackColor	Obtiene o establece el color de fondo del texto del elemento.
Bounds	Obtiene el rectángulo delimitador del elemento, incluidos los subelementos.
Checked	Obtiene o establece un valor que indica si el elemento está activado.
Focused	Obtiene o establece un valor que indica si el elemento tiene el foco en el control ListView.
Font	Obtiene o establece la fuente del texto que muestra el elemento.
ForeColor	Obtiene o establece el color de primer plano del texto del elemento.
Group	Obtiene o establece el grupo al que se asigna el elemento.
ImageIndex	Obtiene o establece el índice de la imagen mostrada para el elemento.
ImageKey	Obtiene o establece la clave para la imagen mostrada para el elemento.
ImageList	Obtiene el ImageList que contiene la imagen mostrada con el elemento.
IndentCount	Obtiene o establece el número de anchos de imagen pequeños por los que aplicar sangría a ListViewItem.
Index	Obtiene el índice de base cero del elemento del control ListView.
ListView	Obtiene el control ListView que contiene el elemento.
Name	Obtiene o establece el nombre asociado a este ListViewItem.
Position	Obtiene o establece la posición de la esquina superior izquierda de ListViewItem.
Selected	Obtiene o establece un valor que indica si el elemento está seleccionado.
StateImageIndex	Obtiene o establece el índice de la imagen de estado (como la imagen de una casilla activada o desactivada que indica el estado del elemento) mostrada para el elemento.
SubItems	Obtiene una colección que contiene todos los subelementos del elemento.
Tag	Obtiene o establece un objeto que contiene datos asociados al elemento.
Text	Obtiene o establece el texto del elemento.
ToolTipText	Obtiene o establece el texto mostrado cuando el puntero del mouse descansa en ListViewItem.
UseItemStyleForSubItems	Obtiene o establece un valor que indica si las propiedades Font, ForeColor y BackColor del elemento se utilizan para todos los subelementos.

Métodos

BeginEdit()	Pone el texto del elemento en modo de edición.
Clone()	Crea una copia idéntica del elemento.
Deserialize(SerializationInfo, StreamingContext)	Deserializa el elemento.
EnsureVisible()	Garantiza que el elemento esté visible en el control, desplazando el contenido del control si es necesario.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FindNearestItem(SearchDirectionHint)	Encuentra el siguiente elemento a partir de ListViewItem, buscando en la dirección especificada.
GetBounds(ItemBoundsPortion)	Recupera la parte especificada del rectángulo delimitador del elemento.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetSubItemAt(Int32, Int32)	Devuelve el subelemento de ListViewItem en las coordenadas especificadas.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove()	Quita el elemento de su control ListView asociado.
Serialize(SerializationInfo, StreamingContext)	Serializa el elemento.
ToString()	Devuelve una cadena que representa el objeto actual.

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializa el elemento.

Se aplica a