ListView.ListViewItemCollection.AddRange ListView.ListViewItemCollection.AddRange ListView.ListViewItemCollection.AddRange ListView.ListViewItemCollection.AddRange Method

Definition

Fügt der Auflistung ein Array von Elementen hinzu.Adds an array of items to the collection.

Überlädt

AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection)

Fügt der Auflistung eine Auflistung von Elementen hinzu.Adds a collection of items to the collection.

AddRange(ListViewItem[]) AddRange(ListViewItem[]) AddRange(ListViewItem[]) AddRange(ListViewItem[])

Fügt der Auflistung ein Array von ListViewItem-Objekten hinzu.Adds an array of ListViewItem objects to the collection.

AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection)

Fügt der Auflistung eine Auflistung von Elementen hinzu.Adds a collection of items to the collection.

public:
 void AddRange(System::Windows::Forms::ListView::ListViewItemCollection ^ items);
public void AddRange (System.Windows.Forms.ListView.ListViewItemCollection items);
member this.AddRange : System.Windows.Forms.ListView.ListViewItemCollection -> unit
Public Sub AddRange (items As ListView.ListViewItemCollection)

Parameter

Ausnahmen

Die enthaltende ListView befindet sich im virtuellen Modus.The containing ListView is in virtual mode.

Hinweise

Wenn die enthaltende ListView sortiert ist, die AddRange Methode fügt die Elemente in der Sortierreihenfolge; andernfalls Es fügt sie am Ende der Auflistung.If the containing ListView is sorted, the AddRange method will add the items in sorted order; otherwise, it will add them to the end of the collection.

AddRange(ListViewItem[]) AddRange(ListViewItem[]) AddRange(ListViewItem[]) AddRange(ListViewItem[])

Fügt der Auflistung ein Array von ListViewItem-Objekten hinzu.Adds an array of ListViewItem objects to the collection.

public:
 void AddRange(cli::array <System::Windows::Forms::ListViewItem ^> ^ items);
public void AddRange (System.Windows.Forms.ListViewItem[] items);
member this.AddRange : System.Windows.Forms.ListViewItem[] -> unit
Public Sub AddRange (items As ListViewItem())

Parameter

items
ListViewItem[]

Ein Array von ListViewItem-Objekten, die der Auflistung hinzugefügt werden sollen.An array of ListViewItem objects to add to the collection.

Ausnahmen

Beispiele

Das folgende Beispiel erstellt eine ListView -Steuerelement mit drei ListViewItem angegebenen Objekte und drei ListViewItem.ListViewSubItem Objekte, die für jedes Element angegeben.The following example creates a ListView control with three ListViewItem objects specified and three ListViewItem.ListViewSubItem objects specified for each item. Außerdem erstellt das Beispiel ColumnHeader Objekte, die Unterelemente in der Detailansicht angezeigt werden sollen.The example also creates ColumnHeader objects to display the subitems in details view. Zwei ImageList Objekte werden im Codebeispiel zu Images für außerdem erstellt der ListViewItem Objekte.Two ImageList objects are also created in the code example to provide images for the ListViewItem objects. Diese ImageList Objekte werden hinzugefügt, um die LargeImageList und SmallImageList Eigenschaften.These ImageList objects are added to the LargeImageList and SmallImageList properties. Im Beispiel verwendet die folgenden Eigenschaften beim Erstellen der ListView Steuerelement:The example uses the following properties in creating the ListView control:

Dieses Beispiel erfordert, dass Sie den Code hinzugefügt haben eine Form und dem Namen der Methode, die im Beispiel aus dem Konstruktor oder eine andere Methode auf dem Formular erstellt.This example requires that you have added the code to a Form and called the method created in the example from the constructor or another method on the form. Das Beispiel erfordert auch, dass die Images mit dem Namen MySmallImage1, MySmallImage2, MyLargeImage1, und MyLargeImage2 befinden sich im Stammverzeichnis von Laufwerk C.The example also requires that images named MySmallImage1, MySmallImage2, MyLargeImage1, and MyLargeImage2 are located in the root directory of drive 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 'CreateMyListView

Hinweise

Sie können diese Methode verwenden, um Elemente aus einer anderen wiederverwenden ListView Steuerelement.You can use this method to reuse items from a different ListView control. Wenn Sie ein einzelnes hinzufügen möchten ListViewItem, verwenden Sie die Add Methode.If you want to add a single ListViewItem, use the Add method. Sie können auch die Insert Methode, wenn Sie ein einzelnes hinzufügen möchten ListViewItem an einer bestimmten Position in der Auflistung.You can also use the Insert method if you want to add a single ListViewItem at a specific position in the collection.

Sie können diese Methode auch verwenden, für das Zuweisen von mehreren ListViewItem Objekte eine ListViewGroup.You can also use this method to assign multiple ListViewItem objects to a ListViewGroup.

Wenn die ListView.Sorting Eigenschaft auf einen Wert festgelegt ist als SortOrder.None oder, wenn die ListViewItemSorter -Eigenschaft festgelegt ist, die Liste sortiert wird, nachdem die Elemente hinzugefügt wurden.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the items are added. Andernfalls werden die Elemente am Ende der Liste eingefügt.Otherwise, the items are inserted at the end of the list. Wenn die Liste nicht sortiert sind, können Sie mithilfe der Insert Methode zum Einfügen von Elementen in der ListView an bestimmten Positionen.If the list is not sorted, you can use the Insert method to insert items into the ListView at specific positions.

Siehe auch

Gilt für: