ListViewItem.ListViewSubItemCollection.Add Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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

Add(String)	Fügt der Auflistung ein Unterelement mit angegebenem Text hinzu.
Add(ListViewItem+ListViewSubItem)	Fügt der Auflistung ein vorhandenes ListViewItem.ListViewSubItem hinzu.
Add(String, Color, Color, Font)	Fügt der Auflistung ein Unterelement mit angegebenem Text und angegebenen Einstellungen für Vorder- und Hintergrundfarbe sowie Schriftarten 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.ListViewSubItem

Public Function Add (text As String) As ListViewItem.ListViewSubItem

Parameter

text: String

Der für das Unterelement anzuzeigende Text.

Gibt zurück

ListViewItem.ListViewSubItem

Das der Auflistung hinzugefügte ListViewItem.ListViewSubItem-Objekt.

Beispiele

Im folgenden Codebeispiel wird ein ListView Steuerelement mit drei ListViewItem angegebenen und drei ListViewItem.ListViewSubItem Objekten erstellt, die für jedes Element angegeben sind. Im Beispiel wird auch Objekte erstellt ColumnHeader , um die Unterelemente in der Detailansicht anzuzeigen. Zwei ImageList Objekte werden auch im Codebeispiel erstellt, um Bilder für die ListViewItem Objekte bereitzustellen. Diese ImageList Objekte werden den und SmallImageList den LargeImageList Eigenschaften hinzugefügt. Im Beispiel werden die folgenden Eigenschaften beim Erstellen des ListView Steuerelements verwendet:

In diesem Beispiel ist erforderlich, dass Sie dem Code einen Code Form hinzugefügt haben und die in dem Beispiel erstellte Methode aus dem Konstruktor oder einer anderen Methode im Formular aufrufen. Das Beispiel erfordert auch, dass Bilder namens MySmallImage1, , MySmallImage2``MyLargeImage1und MyLargeImage2 sich im Stammverzeichnis des Laufwerks C befinden.

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 ein Neues ListViewItem.ListViewSubItem mit dem angegebenen Text erstellt. Anschließend können Sie das ListViewItem.ListViewSubItem von dieser Methode zurückgegebene Objekt verwenden, um Eigenschaften und Aufrufmethoden festzulegen, um das Unterelement zu bearbeiten. Wenn Sie bereits über eine vorhandene Eigenschaft ListViewItem.ListViewSubItem verfügen, die Sie der Auflistung hinzufügen möchten, können Sie die Version der Add Methode verwenden, die einen ListViewItem.ListViewSubItem Parameter akzeptiert, oder die Methode verwenden Insert , wenn Sie das Unterelement an einer bestimmten Position in der Auflistung hinzufügen möchten.

Siehe auch

Insert(Int32, ListViewItem+ListViewSubItem)

Gilt für

Add(ListViewItem+ListViewSubItem)

Fügt der Auflistung ein vorhandenes 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.ListViewSubItem

Public Function Add (item As ListViewItem.ListViewSubItem) As ListViewItem.ListViewSubItem

Parameter

item: ListViewItem.ListViewSubItem

Der der Auflistung hinzuzufügende ListViewItem.ListViewSubItem.

Gibt zurück

ListViewItem.ListViewSubItem

Das der Auflistung hinzugefügte ListViewItem.ListViewSubItem-Objekt.

Hinweise

Sie können diese Version der Add Methode verwenden, um eine vorhandene ListViewItem.ListViewSubItem Sammlung 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. Um ein Element an eine bestimmte Position in die Auflistung einzufügen, verwenden Sie die Insert Methode. Wenn Sie ein Array vorhandener Objekte hinzufügen möchten, können Sie die Version der AddRange Methode verwenden, die ein Array von ListViewItem.ListViewSubItem ListViewItem.ListViewSubItem Objekten als Parameter akzeptiert.

Siehe auch

Gilt für

Add(String, Color, Color, Font)

Fügt der Auflistung ein Unterelement mit angegebenem Text und angegebenen Einstellungen für Vorder- und Hintergrundfarbe sowie Schriftarten 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.ListViewSubItem

Public Function Add (text As String, foreColor As Color, backColor As Color, font As Font) As ListViewItem.ListViewSubItem

Parameter

text: String

Der für das Unterelement anzuzeigende Text.

foreColor: Color

Eine Color, die die Vordergrundfarbe des Unterelements darstellt.

backColor: Color

Eine Color, die die Hintergrundfarbe des Unterelements darstellt.

font: Font

Ein Font, der die Schriftart darstellt, in der der Text des Unterelement angezeigt werden soll.

Gibt zurück

ListViewItem.ListViewSubItem

Das der Auflistung hinzugefügte ListViewItem.ListViewSubItem-Objekt.

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 ermöglicht diese Version der Add Methode, die anfängliche Vordergrundfarbe, Hintergrundfarbe und Schriftart des Unterelementtexts anzugeben. Wenn diese Methode aufgerufen wird, wird ein Neues ListViewItem.ListViewSubItem mit dem angegebenen Text erstellt. Anschließend können Sie das ListViewItem.ListViewSubItem von dieser Methode zurückgegebene Objekt verwenden, um Eigenschaften und Aufrufmethoden festzulegen, um das Unterelement zu bearbeiten. Wenn Sie bereits über eine vorhandene Eigenschaft ListViewItem.ListViewSubItem verfügen, die Sie der Auflistung hinzufügen möchten, können Sie die Version der Add Methode verwenden, die einen ListViewItem.ListViewSubItem Parameter akzeptiert, oder die Methode verwenden, wenn Sie das Insert Unterelement an einer bestimmten Position in der Auflistung hinzufügen möchten.

Hinweis

Standardmäßig verwenden Unterelemente die Vordergrundfarbe, Hintergrundfarbe und Schriftart, die für das übergeordnete Element angegeben ist. Legen Sie die ListViewItem.UseItemStyleForSubItems Eigenschaft fest, false um zu verhindern, dass die übergeordneten Elementformatvorlagen die Unterelementformatvorlagen außer Kraft setzen.

Siehe auch

Gilt für

ListViewItem.ListViewSubItemCollection.Add Methode

Definition

Überlädt

Add(String)

Parameter

Gibt zurück

Beispiele

Hinweise

Siehe auch

Gilt für

Add(ListViewItem+ListViewSubItem)

Parameter

Gibt zurück

Hinweise

Siehe auch

Gilt für

Add(String, Color, Color, Font)

Parameter

Gibt zurück

Hinweise

Siehe auch

Gilt für

Zusätzliche Ressourcen