Exportar (0) Imprimir
Expandir todo

ListViewItem (Clase)

Representa un elemento de un control ListView.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[SerializableAttribute] 
[TypeConverterAttribute(typeof(ListViewItemConverter))] 
public class ListViewItem : ICloneable, ISerializable
/** @attribute SerializableAttribute() */ 
/** @attribute TypeConverterAttribute(System.Windows.Forms.ListViewItemConverter) */ 
public class ListViewItem implements ICloneable, ISerializable
SerializableAttribute 
TypeConverterAttribute(System.Windows.Forms.ListViewItemConverter) 
public class ListViewItem implements ICloneable, ISerializable
No aplicable.

El control ListView es similar a un ListBox en que muestra una lista de elementos. La diferencia principal es que el control ListView proporciona al usuario varias formas distintas de ver los elementos. La clase ListViewItem define la apariencia, el comportamiento y los datos asociados a un elemento que se muestra en el control ListView. Los objetos ListViewItem se pueden mostrar en el control ListView en una de las cuatro vistas disponibles. Los elementos se pueden mostrar como iconos grandes o pequeños, o bien como iconos pequeños en una lista vertical. Los elementos también pueden tener subelementos que contengan 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 identifican la información de un subelemento.

La mayoría de las propiedades de la clase ListViewItem ofrecen formas para cambiar la presentación del elemento en el control ListView al que está asociado. Las propiedades BackColor, ForeColor y Font permiten cambiar la presentación del texto del elemento en el control ListView. La propiedad ImageIndex permite especificar la imagen que se va a cargar desde el ImageList asignado al control ListView (estableciendo las propiedades LargeImageList o SmallImageList del ListView). Los elementos pueden mostrar casillas de verificación para que el usuario pueda especificar opciones de elemento, de forma parecida a un control CheckedListBox. La propiedad Checked se puede utilizar para determinar si un elemento está activado, o bien para activar o desactivar la casilla de verificación en tiempo de ejecución. Los elementos pueden mostrar cualquier número de subelementos cuando la propiedad View del control ListView asociado está establecida en Details y las columnas están definidas en el ListView.ColumnHeaderCollection del control ListView. Se pueden agregar subelementos a un elemento llamando al método Add de la clase ListViewItem.ListViewSubItemCollection. La propiedad SubItems permite obtener acceso a la clase ListViewItem.ListViewSubItemCollection y a sus miembros.

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

La clase ListViewItem también proporciona métodos que no son versiones de los métodos ListView. El método BeginEdit pone el texto del elemento en modo de edición para que el usuario pueda cambiarlo (cuando la propiedad LabelEdit del control ListView está establecida en true). El método Clone permite la creación de copias de objetos ListViewItem existentes para volver a utilizarlos en otros controles ListView.

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

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

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.
    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 void CreateMyListView()
{
    // Create a new ListView control.
    ListView listView1 = new ListView();
    listView1.set_Bounds(new Rectangle(new Point(10, 10), 
        new Size(300, 200)));

    // Set the view to show details.
    listView1.set_View(View.Details);

    // Allow the user to edit item text.
    listView1.set_LabelEdit(true);

    // Allow the user to rearrange columns.
    listView1.set_AllowColumnReorder(true);

    // Display check boxes.
    listView1.set_CheckBoxes(true);

    // Select the item and subitems when selection is made.
    listView1.set_FullRowSelect(true);

    // Display grid lines.
    listView1.set_GridLines(true);

    // Sort the items in the list in ascending order.
    listView1.set_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.set_Checked(true);

    item1.get_SubItems().Add("1");
    item1.get_SubItems().Add("2");
    item1.get_SubItems().Add("3");

    ListViewItem item2 = new ListViewItem("item2", 1);
    item2.get_SubItems().Add("4");
    item2.get_SubItems().Add("5");
    item2.get_SubItems().Add("6");

    ListViewItem item3 = new ListViewItem("item3", 0);

    // Place a check mark next to the item.
    item3.set_Checked(true);

    item3.get_SubItems().Add("7");
    item3.get_SubItems().Add("8");
    item3.get_SubItems().Add("9");

    // Create columns for the items and subitems.
    listView1.get_Columns().Add("Item Column", -2, 
        HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 2", -2, HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 3", -2, HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 4", -2, HorizontalAlignment.Center);

    //Add the items to the ListView.
    listView1.get_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.get_Images().Add(Bitmap.FromFile(
        "C:\\MySmallImage1.bmp"));
    imageListSmall.get_Images().Add(Bitmap.FromFile(
        "C:\\MySmallImage2.bmp"));
    imageListLarge.get_Images().Add(Bitmap.FromFile(
        "C:\\MyLargeImage1.bmp"));
    imageListLarge.get_Images().Add(Bitmap.FromFile(
        "C:\\MyLargeImage2.bmp"));

    //Assign the ImageList objects to the ListView.
    listView1.set_LargeImageList(imageListLarge);
    listView1.set_SmallImageList(imageListSmall);

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

System.Object
  System.Windows.Forms.ListViewItem

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar:
© 2014 Microsoft