ListViewItem.ListViewSubItemCollection.Add Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Adiciona um subitem à coleção de subitens.
Sobrecargas
| Name | Descrição |
|---|---|
| Add(String) |
Adiciona um subitem à coleção com texto especificado. |
| Add(ListViewItem+ListViewSubItem) |
Adiciona um existente ListViewItem.ListViewSubItem à coleção. |
| Add(String, Color, Color, Font) |
Adiciona um subitem à coleção com texto especificado, cor do primeiro plano, cor de fundo e definições de fonte. |
Add(String)
Adiciona um subitem à coleção com 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.ListViewSubItemPublic Function Add (text As String) As ListViewItem.ListViewSubItemParâmetros
- text
- String
O texto a mostrar para o subitem.
Devoluções
Isso ListViewItem.ListViewSubItem foi acrescentado à coleção.
Exemplos
O exemplo de código seguinte cria um ListView controlo com três ListViewItem objetos especificados e três ListViewItem.ListViewSubItem objetos especificados para cada item. O exemplo também cria ColumnHeader objetos para mostrar os subitens na visualização de detalhes. Dois ImageList objetos também são criados no exemplo de código para fornecer imagens para os ListViewItem objetos. Estes ImageList objetos são adicionados às LargeImageList propriedades e.SmallImageList O exemplo utiliza as seguintes propriedades na criação do ListView controlo:
Este exemplo exige que tenha adicionado o código a Form e que chame o método criado no exemplo a partir do construtor ou de outro método no formulário. O exemplo também exige que as imagens nomeadas MySmallImage1, MySmallImage2, MyLargeImage1, e MyLargeImage2 estejam 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
Observações
Esta versão do Add método permite-lhe adicionar um subitem à coleção especificando o texto do subitem. Quando este método é chamado, é criado um novo ListViewItem.ListViewSubItem com o texto especificado. Pode então usar o ListViewItem.ListViewSubItem que é devolvido por este método para definir propriedades e chamar métodos para manipular o subitem. Se já tiver um item existente ListViewItem.ListViewSubItem que queira adicionar à coleção, pode usar a versão do Add método que aceita a ListViewItem.ListViewSubItem como parâmetro, ou usar o Insert método se quiser adicionar o subitem numa posição específica dentro da coleção.
Ver também
Aplica-se a
Add(ListViewItem+ListViewSubItem)
Adiciona um existente ListViewItem.ListViewSubItem à 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.ListViewSubItemPublic Function Add (item As ListViewItem.ListViewSubItem) As ListViewItem.ListViewSubItemParâmetros
A ListViewItem.ListViewSubItem acrescentar à coleção.
Devoluções
Isso ListViewItem.ListViewSubItem foi acrescentado à coleção.
Observações
Pode usar esta versão do Add método para adicionar um existente ListViewItem.ListViewSubItem à coleção. Este método é tipicamente 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 numa posição específica, use o Insert método. Se quiseres adicionar um array de objetos existentes ListViewItem.ListViewSubItem , podes usar a versão do AddRange método que aceita um array de ListViewItem.ListViewSubItem objetos como parâmetro.
Ver também
Aplica-se a
Add(String, Color, Color, Font)
Adiciona um subitem à coleção com texto especificado, cor do primeiro plano, cor de fundo e definições de fonte.
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.ListViewSubItemPublic Function Add (text As String, foreColor As Color, backColor As Color, font As Font) As ListViewItem.ListViewSubItemParâmetros
- text
- String
O texto a mostrar para o subitem.
Devoluções
Isso ListViewItem.ListViewSubItem foi acrescentado à coleção.
Observações
Esta versão do Add método permite-lhe adicionar um subitem à coleção especificando o texto do subitem. Além disso, esta versão do Add método permite especificar a cor inicial em primeiro plano, a cor de fundo e a fonte do texto do subitem. Quando este método é chamado, é criado um novo ListViewItem.ListViewSubItem com o texto especificado. Pode então usar o ListViewItem.ListViewSubItem que é devolvido por este método para definir propriedades e chamar métodos para manipular o subitem. Se já tiver um elemento existente ListViewItem.ListViewSubItem que queira adicionar à coleção, pode usar a versão do Add método que aceita a ListViewItem.ListViewSubItem como parâmetro, ou usar o Insert método se quiser adicionar o subitem numa posição específica da coleção.
Note
Por defeito, os subitens usam a cor do primeiro plano, a cor de fundo e a fonte especificadas para o item pai. Defina a ListViewItem.UseItemStyleForSubItems propriedade para false evitar que os estilos de item pai sobreponham os estilos de subitems.
