Partilhar via


ListViewItem.ListViewSubItemCollection.Add Método

Definição

Adiciona um subitem à coleção de subitens.

Sobrecargas

Add(String)

Adiciona um subitem à coleção com o texto especificado.

Add(ListViewItem+ListViewSubItem)

Adiciona um ListViewItem.ListViewSubItem existente à coleção.

Add(String, Color, Color, Font)

Adiciona um subitem à coleção com as configurações de fonte, cor de primeiro plano, cor da tela de fundo e texto especificadas.

Add(String)

Adiciona um subitem à coleção com o 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

O texto a ser exibido para o subitem.

Retornos

ListViewItem.ListViewSubItem

O ListViewItem.ListViewSubItem adicionado à coleção.

Exemplos

O exemplo de código a seguir cria um ListView controle com três ListViewItem objetos especificados e três ListViewItem.ListViewSubItem objetos especificados para cada item. O exemplo também cria ColumnHeader objetos para exibir os subitens na exibição de detalhes. Dois ImageList objetos também são criados no exemplo de código para fornecer imagens para os ListViewItem objetos. Esses ImageList objetos são adicionados ao e SmallImageList às LargeImageList propriedades. O exemplo usa as seguintes propriedades na criação do ListView controle:

Este exemplo requer que você tenha adicionado o código a um Form e chame o método criado no exemplo do construtor ou de outro método no formulário. O exemplo também requer que as imagens nomeadasMySmallImage1``MySmallImage2``MyLargeImage1, e MyLargeImage2 estão localizadas no diretório raiz da unidade 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

Comentários

Essa versão do Add método permite que você adicione um subtem à coleção especificando o texto do subitem. Quando esse método é chamado, um novo ListViewItem.ListViewSubItem é criado com o texto especificado. Em seguida, você pode usar o ListViewItem.ListViewSubItem que é retornado por esse método para definir propriedades e chamar métodos para manipular o subitem. Se você já tiver um existente ListViewItem.ListViewSubItem que deseja adicionar à coleção, poderá usar a versão do Add método que aceita um ListViewItem.ListViewSubItem parâmetro ou usar o Insert método se quiser adicionar o subitem a uma posição específica dentro da coleção.

Confira também

Aplica-se a

Add(ListViewItem+ListViewSubItem)

Adiciona um ListViewItem.ListViewSubItem existente à coleção.

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

Retornos

ListViewItem.ListViewSubItem

O ListViewItem.ListViewSubItem adicionado à coleção.

Comentários

Você pode usar essa versão do Add método para adicionar um existente ListViewItem.ListViewSubItem à coleção. Esse método normalmente é usado para reutilizar subitens existentes de outros ListViewItem objetos. Os itens adicionados à coleção são inseridos no final da lista. Para inserir um item na coleção em uma posição específica, use o Insert método. Se você quiser adicionar uma matriz de objetos existentes ListViewItem.ListViewSubItem , poderá usar a versão do AddRange método que aceita uma matriz de ListViewItem.ListViewSubItem objetos como um parâmetro.

Confira também

Aplica-se a

Add(String, Color, Color, Font)

Adiciona um subitem à coleção com as configurações de fonte, cor de primeiro plano, cor da tela de fundo e texto especificadas.

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

O texto a ser exibido para o subitem.

foreColor
Color

Um Color que representa a cor de primeiro plano do subitem.

backColor
Color

Um Color que representa a cor da tela de fundo do subitem.

font
Font

Um Font que representa a face de tipos na qual exibir o texto do subitem.

Retornos

ListViewItem.ListViewSubItem

O ListViewItem.ListViewSubItem adicionado à coleção.

Comentários

Essa versão do Add método permite que você adicione um subtem à coleção especificando o texto do subitem. Além disso, essa versão do Add método permite que você especifique a cor inicial do primeiro plano, a cor da tela de fundo e a fonte do texto do subtem. Quando esse método é chamado, um novo ListViewItem.ListViewSubItem é criado com o texto especificado. Em seguida, você pode usar o ListViewItem.ListViewSubItem que é retornado por esse método para definir propriedades e chamar métodos para manipular o subitem. Se você já tiver um existente ListViewItem.ListViewSubItem que deseja adicionar à coleção, poderá usar a versão do Add método que aceita um ListViewItem.ListViewSubItem parâmetro ou usar o Insert método se quiser adicionar o subitem a uma posição específica na coleção.

Observação

Por padrão, os subitens usam a cor do primeiro plano, a cor da tela de fundo e a fonte especificadas para o item pai. Defina a ListViewItem.UseItemStyleForSubItems propriedade para false impedir que os estilos de item pai substituam os estilos de subitem.

Confira também

Aplica-se a