ListViewItem.ListViewSubItem Clase

Definición

Representa un subelemento de un ListViewItem.Represents a subitem of a ListViewItem.

public: ref class ListViewItem::ListViewSubItem
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewSubItemConverter))]
[System.Serializable]
public class ListViewItem.ListViewSubItem
type ListViewItem.ListViewSubItem = class
Public Class ListViewItem.ListViewSubItem
Herencia
ListViewItem.ListViewSubItem
Atributos

Ejemplos

En el ejemplo de código siguiente ListView se crea un ListViewItem control con tres objetos ListViewItem.ListViewSubItem especificados y tres objetos especificados para cada elemento.The following code example creates a ListView control with three ListViewItem objects specified and three ListViewItem.ListViewSubItem objects specified for each item. En el ejemplo también ColumnHeader se crean objetos para mostrar los subelementos en la vista de detalles.The example also creates ColumnHeader objects to display the subitems in details view. También ImageList se crean dos objetos en el ejemplo de código para proporcionar imágenes para ListViewItem los objetos.Two ImageList objects are also created in the code example to provide images for the ListViewItem objects. Estos ImageList objetos se agregan a LargeImageList las SmallImageList propiedades y.These ImageList objects are added to the LargeImageList and SmallImageList properties. En el ejemplo se usan las siguientes propiedades para ListView crear el control.The example uses the following properties in creating the ListView control.

Debe agregar el código a un Form y llamar al método creado en el ejemplo desde el constructor u otro método del formulario.You need to add the code to a Form and call the method created in the example from the constructor or another method on the form. El ejemplo requiere que las imágenes MySmallImage1denominadas MyLargeImage1, MySmallImage2, MyLargeImage2 y se encuentren en el directorio raíz de la unidad C.The example requires that images named MySmallImage1, MySmallImage2, MyLargeImage1, and MyLargeImage2 are located in the root directory of drive 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

Un ListView control muestra una lista de elementos definidos por la ListViewItem clase.A ListView control displays a list of items that are defined by the ListViewItem class. Cada ListViewItem puede almacenar objetos de subelemento definidos por la ListViewItem.ListViewSubItem clase.Each ListViewItem can store subitem objects that are defined by the ListViewItem.ListViewSubItem class. Los subelementos se muestran cuando View la propiedad ListView del control se establece en Details.Subitems are displayed when the View property of the ListView control is set to Details. Normalmente, los subelementos contienen información relacionada con su elemento primario.Typically, subitems contain information that is related to their parent item. Por ejemplo, si un ListView control muestra elementos que representan pedidos, cada elemento podría mostrar el número de pedido.For example, if a ListView control displays items that represent orders, each item could display the order number. Se pueden agregar subelementos a cada elemento para mostrar información como, por ejemplo, el producto pedido, la cantidad de artículos solicitados y el precio total de los artículos solicitados.Subitems could be added to each item to display information such as the product ordered, the quantity of items ordered, and the total price of the items ordered. A diferencia ListViewItem de los ListViewItem.ListViewSubItem objetos, los objetos no se pueden editar directamente por el usuario ( ListViewItem el usuario puede LabelEdit editar objetos si ListView la propiedad del control trueestá establecida en).Unlike ListViewItem objects, ListViewItem.ListViewSubItem objects cannot be edited directly by the user (the user can edit ListViewItem objects if the LabelEdit property of the ListView control is set to true).

Dado que el usuario no puede editar directamente los subelementos y no muestra las imágenes, las propiedades se limitan a los que afectan al estilo del texto del subelemento cuando se muestra ListView en el control.Because subitems cannot be directly edited by the user and do not display images, properties are limited to those that affect the style of the subitem text when it is displayed in the ListView control. Si la UseItemStyleForSubItems ListView propiedad de que contiene los subelementos está establecida en false, puede utilizar las Fontpropiedades, BackColory ForeColor para cambiar los estilos aplicados a la presentación del texto.If the UseItemStyleForSubItems property of the ListView that contains the subitems is set to false, you can use the Font, BackColor, and ForeColor properties to change the styles applied to the text display. Normalmente, los estilos del elemento y los subelementos son los mismos en un ListView control, pero si desea cambiar el estilo de un específico ListViewItem.ListViewSubItem para resaltarlo, puede usar estas propiedades en los elementos que desea mostrar de manera diferente.Typically, the styles of the item and the subitems are the same in a ListView control, but if you want to change the style of a specific ListViewItem.ListViewSubItem to highlight it, you can use these properties on the items you want to display differently.

Constructores

ListViewItem.ListViewSubItem()

Inicializa una nueva instancia de la clase ListViewItem.ListViewSubItem con valores predeterminados.Initializes a new instance of the ListViewItem.ListViewSubItem class with default values.

ListViewItem.ListViewSubItem(ListViewItem, String)

Inicializa una nueva instancia de la clase ListViewItem.ListViewSubItem con el propietario y el texto especificados.Initializes a new instance of the ListViewItem.ListViewSubItem class with the specified owner and text.

ListViewItem.ListViewSubItem(ListViewItem, String, Color, Color, Font)

Inicializa una nueva instancia de la clase ListViewItem.ListViewSubItem con los valores de propietario, texto, color de primer plano, color de fondo y fuente especificados.Initializes a new instance of the ListViewItem.ListViewSubItem class with the specified owner, text, foreground color, background color, and font values.

Propiedades

BackColor

Obtiene o establece el color de fondo del texto del subelemento.Gets or sets the background color of the subitem's text.

Bounds

Obtiene el rectángulo delimitador del ListViewItem.ListViewSubItem.Gets the bounding rectangle of the ListViewItem.ListViewSubItem.

Font

Obtiene o establece la fuente del texto que muestra el subelemento.Gets or sets the font of the text displayed by the subitem.

ForeColor

Obtiene o establece el color de primer plano del texto del subelemento.Gets or sets the foreground color of the subitem's text.

Name

Obtiene o establece el nombre de ListViewItem.ListViewSubItem.Gets or sets the name of the ListViewItem.ListViewSubItem.

Tag

Obtiene o establece un objeto que contiene datos sobre el control ListViewItem.ListViewSubItem.Gets or sets an object that contains data about the ListViewItem.ListViewSubItem.

Text

Obtiene o establece el texto del subelemento.Gets or sets the text of the subitem.

Métodos

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)
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)
MemberwiseClone()

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

(Heredado de Object)
ResetStyle()

Restablece la fuente y los colores predeterminados de los estilos aplicados al subelemento.Resets the styles applied to the subitem to the default font and colors.

ToString()

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

Se aplica a

Consulte también: