ListViewItem.ListViewSubItemCollection.Add Methode

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

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:

• View

• LabelEdit

• AllowColumnReorder

• CheckBoxes

• FullRowSelect

• GridLines

• Sorting

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)

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

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

• AddRange(ListViewItem+ListViewSubItem[])
• Insert(Int32, ListViewItem+ListViewSubItem)

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

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.

Siehe auch

• Color
• Font
• Insert(Int32, ListViewItem+ListViewSubItem)