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

定义

向集合添加项的数组。Adds an array of items to the collection.

重载

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

向集合中添加项的集合。Adds a collection of items to the collection.

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

向集合中添加 ListViewItem 对象的数组。Adds an array of ListViewItem objects to the collection.

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

向集合中添加项的集合。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)

参数

异常

注解

如果包含ListView的已排序,则AddRange方法将按排序顺序添加项; 否则,它会将它们添加到集合的末尾。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[])

向集合中添加 ListViewItem 对象的数组。Adds an array of ListViewItem objects to the collection.

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

参数

items
ListViewItem[]

要添加到集合中的 ListViewItem 对象的数组。An array of ListViewItem objects to add to the collection.

异常

示例

下面的示例创建一个ListView控件,其中ListViewItem指定了三个ListViewItem.ListViewSubItem对象,并为每个项指定了三个对象。The following example creates a ListView control with three ListViewItem objects specified and three ListViewItem.ListViewSubItem objects specified for each item. 该示例还创建ColumnHeader了用于在详细信息视图中显示子项的对象。The example also creates ColumnHeader objects to display the subitems in details view. ImageList代码示例中还创建了两个对象,以便为ListViewItem对象提供图像。Two ImageList objects are also created in the code example to provide images for the ListViewItem objects. 这些ImageList对象将添加LargeImageList到和SmallImageList属性。These ImageList objects are added to the LargeImageList and SmallImageList properties. 该示例使用以下属性创建ListView控件:The example uses the following properties in creating the ListView control:

此示例要求您已将代码添加到Form ,并从构造函数或窗体上的其他方法调用在示例中创建的方法。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. 该示例还要求MySmallImage1名为MyLargeImage1MySmallImage2、和MyLargeImage2的映像位于驱动器 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

注解

您可以使用此方法重用不同ListView控件中的项。You can use this method to reuse items from a different ListView control. 如果要添加单个ListViewItem,请Add使用方法。If you want to add a single ListViewItem, use the Add method. 如果要在集合中Insert的特定位置添加单个ListViewItem ,还可以使用方法。You can also use the Insert method if you want to add a single ListViewItem at a specific position in the collection.

你还可以使用此方法将多个ListViewItem对象ListViewGroup分配给。You can also use this method to assign multiple ListViewItem objects to a ListViewGroup.

如果将SortOrder.None ListViewItemSorter属性设置为以外的值,或者如果设置了属性,则会在添加项后对该列表进行排序。 ListView.SortingIf 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. 否则,项将插入到列表的末尾。Otherwise, the items are inserted at the end of the list. 如果列表未排序,则可以使用Insert方法将项插入到中的ListView特定位置。If the list is not sorted, you can use the Insert method to insert items into the ListView at specific positions.

另请参阅

适用于