Compartir vía


ListViewItem.ListViewSubItemCollection.Add Método

Definición

Agrega un subelemento a la colección de subelementos.

Sobrecargas

Add(String)

Agrega un subelemento a la colección con el texto especificado.

Add(ListViewItem+ListViewSubItem)

Agrega un objeto ListViewItem.ListViewSubItem existente a la colección.

Add(String, Color, Color, Font)

Agrega un subelemento a la colección con los valores de texto, color de primer plano, color de fondo y fuente especificados.

Add(String)

Agrega un subelemento a la colección con el texto especificado.

public:
 System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::String ^ text);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add (string text);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add (string? text);
member this.Add : string -> System.Windows.Forms.ListViewItem.ListViewSubItem
Public Function Add (text As String) As ListViewItem.ListViewSubItem

Parámetros

text
String

Texto que se mostrará para el subelemento.

Devoluciones

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem que se agregó a la colección.

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:

Este ejemplo requiere que haya agregado el código a Form y llame al método creado en el ejemplo desde el constructor u otro método del formulario. El ejemplo también 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

Esta versión del Add método permite agregar un subelemento a la colección especificando el texto del subelemento. Cuando se llama a este método, se crea un nuevo ListViewItem.ListViewSubItem con el texto especificado. A continuación, puede usar el ListViewItem.ListViewSubItem que devuelve este método para establecer propiedades y llamar a métodos para manipular el subelemento. Si ya tiene un existente ListViewItem.ListViewSubItem que desea agregar a la colección, puede usar la versión del método que acepta un ListViewItem.ListViewSubItem como parámetro o usar el Insert método si desea agregar el subelemento en una posición específica dentro de Add la colección.

Consulte también

Se aplica a

Add(ListViewItem+ListViewSubItem)

Agrega un objeto ListViewItem.ListViewSubItem existente a la colección.

public:
 System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::Windows::Forms::ListViewItem::ListViewSubItem ^ item);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add (System.Windows.Forms.ListViewItem.ListViewSubItem item);
member this.Add : System.Windows.Forms.ListViewItem.ListViewSubItem -> System.Windows.Forms.ListViewItem.ListViewSubItem
Public Function Add (item As ListViewItem.ListViewSubItem) As ListViewItem.ListViewSubItem

Parámetros

item
ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem que se agrega a la colección.

Devoluciones

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem que se agregó a la colección.

Comentarios

Puede usar esta versión del Add método para agregar una existente ListViewItem.ListViewSubItem a la colección. Este método se usa normalmente para reutilizar los subelementos existentes de otros ListViewItem objetos. Los elementos que se agregan a la colección se insertan al final de la lista. Para insertar un elemento en la colección en una posición específica, use el Insert método . Si desea agregar una matriz de objetos existentes ListViewItem.ListViewSubItem , puede usar la versión del AddRange método que acepta una matriz de ListViewItem.ListViewSubItem objetos como parámetro.

Consulte también

Se aplica a

Add(String, Color, Color, Font)

Agrega un subelemento a la colección con los valores de texto, color de primer plano, color de fondo y fuente especificados.

public:
 System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::String ^ text, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add (string text, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public System.Windows.Forms.ListViewItem.ListViewSubItem Add (string? text, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
member this.Add : string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem.ListViewSubItem
Public Function Add (text As String, foreColor As Color, backColor As Color, font As Font) As ListViewItem.ListViewSubItem

Parámetros

text
String

Texto que se mostrará para el subelemento.

foreColor
Color

Color que representa el color de primer plano del subelemento.

backColor
Color

Color que representa el color de fondo del subelemento.

font
Font

Font que representa el tipo de letra con el que se va a mostrar el texto del subelemento.

Devoluciones

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem que se agregó a la colección.

Comentarios

Esta versión del Add método permite agregar un subelemento a la colección especificando el texto del subelemento. Además, esta versión del Add método permite especificar el color de primer plano inicial, el color de fondo y la fuente del texto del subelemento. Cuando se llama a este método, se crea un nuevo ListViewItem.ListViewSubItem con el texto especificado. A continuación, puede usar el ListViewItem.ListViewSubItem que devuelve este método para establecer propiedades y llamar a métodos para manipular el subelemento. Si ya tiene un existente ListViewItem.ListViewSubItem que desea agregar a la colección, puede usar la versión del Add método que acepta un ListViewItem.ListViewSubItem como parámetro o usar el Insert método si desea agregar el subelemento en una posición específica de la colección.

Nota

De forma predeterminada, los subelementos usan el color de primer plano, el color de fondo y la fuente especificados para el elemento primario. Establezca la ListViewItem.UseItemStyleForSubItems propiedad en false para impedir que los estilos de elemento primario invalide los estilos de subelemento.

Consulte también

Se aplica a