ListViewItem.ListViewSubItemCollection.Add Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Voegt een subitem toe aan de verzameling subitems.
Overloads
| Name | Description |
|---|---|
| Add(String) |
Hiermee voegt u een subitem toe aan de verzameling met opgegeven tekst. |
| Add(ListViewItem+ListViewSubItem) |
Voegt een bestaande ListViewItem.ListViewSubItem aan de verzameling toe. |
| Add(String, Color, Color, Font) |
Voegt een subitem toe aan de verzameling met opgegeven tekst, voorgrondkleur, achtergrondkleur en lettertype-instellingen. |
Add(String)
Hiermee voegt u een subitem toe aan de verzameling met opgegeven tekst.
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.ListViewSubItemParameters
- text
- String
De tekst die moet worden weergegeven voor de subitem.
Retouren
De ListViewItem.ListViewSubItem gegevens die aan de verzameling zijn toegevoegd.
Voorbeelden
In het volgende codevoorbeeld wordt een ListView besturingselement gemaakt met drie ListViewItem opgegeven objecten en drie ListViewItem.ListViewSubItem objecten die voor elk item zijn opgegeven. In het voorbeeld worden ook objecten gemaakt ColumnHeader om de subitems weer te geven in de detailweergave. Er worden ook twee ImageList objecten gemaakt in het codevoorbeeld om afbeeldingen voor de ListViewItem objecten te bieden. Deze ImageList objecten worden toegevoegd aan de LargeImageList en SmallImageList eigenschappen. In het voorbeeld worden de volgende eigenschappen gebruikt bij het maken van het ListView besturingselement:
Voor dit voorbeeld moet u de code hebben toegevoegd aan een Form en de methode aanroepen die in het voorbeeld is gemaakt vanuit de constructor of een andere methode op het formulier. Het voorbeeld vereist ook dat installatiekopieën met de naam MySmallImage1, MySmallImage2en MyLargeImage1MyLargeImage2 zich bevinden in de hoofdmap van station 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
Opmerkingen
Met deze versie van de Add methode kunt u een subitem toevoegen aan de verzameling door de tekst van het subitem op te geven. Wanneer deze methode wordt aangeroepen, wordt er een nieuwe ListViewItem.ListViewSubItem gemaakt met de opgegeven tekst. Vervolgens kunt u de ListViewItem.ListViewSubItem geretourneerde methode gebruiken om eigenschappen in te stellen en methoden aan te roepen om het subitem te bewerken. Als u al een bestaande ListViewItem.ListViewSubItem hebt die u aan de verzameling wilt toevoegen, kunt u de versie van de Add methode gebruiken die een ListViewItem.ListViewSubItem parameter accepteert of de Insert methode gebruiken als u de subitem op een specifieke positie in de verzameling wilt toevoegen.
Zie ook
Van toepassing op
Add(ListViewItem+ListViewSubItem)
Voegt een bestaande ListViewItem.ListViewSubItem aan de verzameling toe.
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.ListViewSubItemParameters
De ListViewItem.ListViewSubItem toe te voegen aan de verzameling.
Retouren
De ListViewItem.ListViewSubItem gegevens die aan de verzameling zijn toegevoegd.
Opmerkingen
U kunt deze versie van de Add methode gebruiken om een bestaande ListViewItem.ListViewSubItem aan de verzameling toe te voegen. Deze methode wordt doorgaans gebruikt om bestaande subitems van andere ListViewItem objecten opnieuw te gebruiken. Items die aan de verzameling worden toegevoegd, worden aan het einde van de lijst ingevoegd. Als u een item op een specifieke positie in de verzameling wilt invoegen, gebruikt u de Insert methode. Als u een matrix met bestaande ListViewItem.ListViewSubItem objecten wilt toevoegen, kunt u de versie van de AddRange methode gebruiken die een matrix met ListViewItem.ListViewSubItem objecten accepteert als parameter.
Zie ook
Van toepassing op
Add(String, Color, Color, Font)
Voegt een subitem toe aan de verzameling met opgegeven tekst, voorgrondkleur, achtergrondkleur en lettertype-instellingen.
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.ListViewSubItemParameters
- text
- String
De tekst die moet worden weergegeven voor de subitem.
Retouren
De ListViewItem.ListViewSubItem gegevens die aan de verzameling zijn toegevoegd.
Opmerkingen
Met deze versie van de Add methode kunt u een subitem toevoegen aan de verzameling door de tekst van het subitem op te geven. Bovendien kunt u met deze versie van de Add methode de eerste voorgrondkleur, achtergrondkleur en het lettertype van de subitemtekst opgeven. Wanneer deze methode wordt aangeroepen, wordt er een nieuwe ListViewItem.ListViewSubItem gemaakt met de opgegeven tekst. Vervolgens kunt u de ListViewItem.ListViewSubItem geretourneerde methode gebruiken om eigenschappen in te stellen en methoden aan te roepen om het subitem te bewerken. Als u al een bestaande ListViewItem.ListViewSubItem hebt die u aan de verzameling wilt toevoegen, kunt u de versie van de Add methode gebruiken die een ListViewItem.ListViewSubItem parameter accepteert of de Insert methode gebruiken als u de subitem op een specifieke positie in de verzameling wilt toevoegen.
Note
Subitems gebruiken standaard de voorgrondkleur, achtergrondkleur en het lettertype dat is opgegeven voor het bovenliggende item. Stel de ListViewItem.UseItemStyleForSubItems eigenschap in om te false voorkomen dat de stijlen voor bovenliggende items de subitemstijlen overschrijven.
