Esta documentación está archivada y no tiene mantenimiento.

ListViewItem.ListViewSubItem (Clase)

Representa un subelemento de un ListViewItem.

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

[SerializableAttribute] 
[TypeConverterAttribute(typeof(ListViewSubItemConverter))] 
public class ListViewSubItem
/** @attribute SerializableAttribute() */ 
/** @attribute TypeConverterAttribute(System.Windows.Forms.ListViewSubItemConverter) */ 
public class ListViewSubItem
SerializableAttribute 
TypeConverterAttribute(System.Windows.Forms.ListViewSubItemConverter) 
public class ListViewSubItem
No aplicable.

Un control ListView muestra una lista de elementos definidos por la clase ListViewItem. Cada ListViewItem puede almacenar objetos de subelementos definidos por la clase ListViewItem.ListViewSubItem. Los subelementos se muestran cuando la propiedad View del control ListView se establece en Details. Normalmente, los subelementos contienen información relacionada con su elemento primario. Por ejemplo, si un control ListView muestra elementos que representan pedidos, cada elemento puede mostrar el número de pedido. Los subelementos se pueden agregar a cada elemento para mostrar información como el producto solicitado, la cantidad de elementos solicitados y el precio total de los elementos solicitados. A diferencia de los objetos ListViewItem, el usuario no puede editar directamente los objetos ListViewItem.ListViewSubItem (el usuario puede editar objetos ListViewItem si la propiedad LabelEdit del control ListView está establecida en true).

Puesto que el usuario no puede editar directamente subelementos y que éstos no muestran imágenes, las propiedades se limitan a aquellas que afectan al estilo del texto de los subelementos cuando aparecen en el control ListView. Si la propiedad UseItemStyleForSubItems del ListView que contiene los subelementos se establece en false, se pueden utilizar las propiedades Font, BackColor y ForeColor para cambiar los estilos aplicados a la vista del texto. Normalmente, los estilos del elemento y los subelementos son los mismos en un control ListView, pero si desea cambiar el estilo de un ListViewItem.ListViewSubItem específico para resaltarlo, puede utilizar estas propiedades en los elementos que desee mostrar de forma distinta.

En el ejemplo de código siguiente se crea un control ListView con tres objetos ListViewItem y tres objetos ListViewItem.ListViewSubItem especificados para cada elemento. Asimismo se crean objetos ColumnHeader para mostrar los subelementos en la vista de detalles. También se crean dos objetos ImageList en el ejemplo de código 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.ListViewSubItem

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: