ListViewItem.ListViewSubItemCollection.Add Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Auflistung von Unterelementen ein Unterelement hinzu.
Überlädt
| Name | Beschreibung |
|---|---|
| Add(String) |
Fügt der Auflistung ein Unterelement mit angegebenem Text hinzu. |
| Add(ListViewItem+ListViewSubItem) |
Fügt der Auflistung eine vorhandene ListViewItem.ListViewSubItem hinzu. |
| Add(String, Color, Color, Font) |
Fügt der Auflistung ein Unterelement mit angegebenen Text-, Vordergrundfarbe, Hintergrundfarbe und Schriftarteinstellungen hinzu. |
Add(String)
Fügt der Auflistung ein Unterelement mit angegebenem Text hinzu.
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.ListViewSubItemParameter
- text
- String
Der text, der für das Unterelement angezeigt werden soll.
Gibt zurück
Das ListViewItem.ListViewSubItem , das der Auflistung hinzugefügt wurde.
Beispiele
Im folgenden Codebeispiel wird ein ListView Steuerelement mit drei ListViewItem angegebenen Objekten und drei ListViewItem.ListViewSubItem Für jedes Element angegebenen Objekten erstellt. Im Beispiel werden auch Objekte zum Anzeigen der Unterelemente in der Detailansicht erstellt ColumnHeader . Im Codebeispiel werden auch zwei ImageList Objekte erstellt, um Bilder für die ListViewItem Objekte bereitzustellen. Diese ImageList Objekte werden den LargeImageList Und SmallImageList Eigenschaften hinzugefügt. Im Beispiel werden die folgenden Eigenschaften beim Erstellen des ListView Steuerelements verwendet:
In diesem Beispiel müssen Sie dem Code hinzugefügt Form und die im Beispiel erstellte Methode aus dem Konstruktor oder einer anderen Methode im Formular aufrufen. Das Beispiel erfordert außerdem, dass Bilder namens MySmallImage1, MySmallImage2, MyLargeImage1, und MyLargeImage2 befinden sich im Stammverzeichnis von Laufwerk 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
Hinweise
Mit dieser Version der Add Methode können Sie der Auflistung ein Unterelement hinzufügen, indem Sie den Text des Unterelements angeben. Wenn diese Methode aufgerufen wird, wird eine neue ListViewItem.ListViewSubItem mit dem angegebenen Text erstellt. Anschließend können Sie das ListViewItem.ListViewSubItem von dieser Methode zurückgegebene Objekt verwenden, um Eigenschaften festzulegen und Methoden aufzurufen, um das Unterelement zu bearbeiten. Wenn Sie bereits über eine Vorhandene verfügen ListViewItem.ListViewSubItem , die Sie der Auflistung hinzufügen möchten, können Sie die Version der Methode verwenden, die Add einen ListViewItem.ListViewSubItem als Parameter akzeptiert, oder die Insert Methode verwenden, wenn Sie das Unterelement an einer bestimmten Position innerhalb der Auflistung hinzufügen möchten.
Weitere Informationen
Gilt für:
Add(ListViewItem+ListViewSubItem)
Fügt der Auflistung eine vorhandene ListViewItem.ListViewSubItem hinzu.
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.ListViewSubItemParameter
Das ListViewItem.ListViewSubItem , das der Auflistung hinzugefügt werden soll.
Gibt zurück
Das ListViewItem.ListViewSubItem , das der Auflistung hinzugefügt wurde.
Hinweise
Sie können diese Version der Add Methode verwenden, um der Auflistung eine vorhandene ListViewItem.ListViewSubItem Hinzuzufügen. Diese Methode wird in der Regel verwendet, um vorhandene Unterelemente aus anderen ListViewItem Objekten wiederzuverwenden. Elemente, die der Auflistung hinzugefügt werden, werden am Ende der Liste eingefügt. Verwenden Sie die Insert Methode, um ein Element an einer bestimmten Position in die Auflistung einzufügen. Wenn Sie ein Array vorhandener ListViewItem.ListViewSubItem Objekte hinzufügen möchten, können Sie die Version der Methode verwenden, die AddRange ein Array von ListViewItem.ListViewSubItem Objekten als Parameter akzeptiert.
Weitere Informationen
Gilt für:
Add(String, Color, Color, Font)
Fügt der Auflistung ein Unterelement mit angegebenen Text-, Vordergrundfarbe, Hintergrundfarbe und Schriftarteinstellungen hinzu.
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.ListViewSubItemParameter
- text
- String
Der text, der für das Unterelement angezeigt werden soll.
Gibt zurück
Das ListViewItem.ListViewSubItem , das der Auflistung hinzugefügt wurde.
Hinweise
Mit dieser Version der Add Methode können Sie der Auflistung ein Unterelement hinzufügen, indem Sie den Text des Unterelements angeben. Darüber hinaus können Sie mit dieser Version der Add Methode die anfängliche Vordergrundfarbe, Hintergrundfarbe und Schriftart des Unterelementtexts angeben. Wenn diese Methode aufgerufen wird, wird eine neue ListViewItem.ListViewSubItem mit dem angegebenen Text erstellt. Anschließend können Sie das ListViewItem.ListViewSubItem von dieser Methode zurückgegebene Objekt verwenden, um Eigenschaften festzulegen und Methoden aufzurufen, um das Unterelement zu bearbeiten. Wenn Sie bereits über eine Vorhandene verfügen ListViewItem.ListViewSubItem , die Sie der Auflistung hinzufügen möchten, können Sie die Version der Methode verwenden, die Add einen ListViewItem.ListViewSubItem als Parameter akzeptiert, oder die Insert Methode verwenden, wenn Sie das Unterelement an einer bestimmten Position in der Auflistung hinzufügen möchten.
Hinweis
Unterelemente verwenden standardmäßig die Vordergrundfarbe, Hintergrundfarbe und Schriftart, die für das übergeordnete Element angegeben ist. Legen Sie die ListViewItem.UseItemStyleForSubItems Eigenschaft fest, um zu false verhindern, dass die Formatvorlagen für übergeordnete Elemente die Unterelementformatvorlagen überschrieben werden.
