Sdílet prostřednictvím

ListView.ListViewItemCollection.AddRange Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Přidá do kolekce pole položek.

Přetížení

AddRange(ListView+ListViewItemCollection)

Přidá kolekci položek do kolekce.
AddRange(ListViewItem[])

Přidá do kolekce pole ListViewItem objektů.

AddRange(ListView+ListViewItemCollection)

Přidá kolekci položek do kolekce.

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)

Parametry

items
ListView.ListViewItemCollection

Přidá ListView.ListViewItemCollection se do kolekce.

Výjimky

ArgumentNullException

items je null.

InvalidOperationException

Obsahující ListView je ve virtuálním režimu.

Poznámky

Pokud je obsah ListView seřazený, AddRange metoda přidá položky v seřazené pořadí, jinak je přidá na konec kolekce.

Platí pro

AddRange(ListViewItem[])

Přidá do kolekce pole ListViewItem objektů.

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

Parametry

valuesitems
ListViewItem[]

Pole ListViewItem objektů, které se mají přidat do kolekce.

Výjimky

ArgumentNullException

items je null.

Příklady

Následující příklad vytvoří ListView ovládací prvek se třemi ListViewItem zadanými objekty a třemi ListViewItem.ListViewSubItem objekty zadanými pro každou položku. Příklad také vytvoří ColumnHeader objekty pro zobrazení podřízených položek v zobrazení podrobností. V příkladu kódu jsou také vytvořeny dva ImageList objekty, které poskytují obrázky pro ListViewItem objekty. Tyto ImageList objekty se přidají do LargeImageList vlastností a SmallImageList . V příkladu se při vytváření ListView ovládacího prvku používají následující vlastnosti:

Tento příklad vyžaduje, abyste přidali kód do objektu Form a volali metodu vytvořenou v příkladu z konstruktoru nebo jiné metody ve formuláři. Příklad také vyžaduje, aby se image s názvy MySmallImage1, MySmallImage2MyLargeImage1, a MyLargeImage2 nacházely v kořenovém adresáři jednotky 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

Poznámky

Tuto metodu můžete použít k opakovanému použití položek z jiného ListView ovládacího prvku. Pokud chcete přidat jeden ListViewItem, použijte metodu Add . Můžete také použít metodu Insert , pokud chcete přidat jeden ListViewItem na konkrétní pozici v kolekci.

Tuto metodu můžete použít také k přiřazení více ListViewItem objektů k objektu ListViewGroup.

ListView.Sorting Pokud je vlastnost nastavena na jinou hodnotu než SortOrder.None nebo pokud ListViewItemSorter je vlastnost nastavena, seznam se seřadí po přidání položek. V opačném případě se položky vloží na konec seznamu. Pokud seznam není seřazený, můžete pomocí Insert metody vložit položky na ListView konkrétní pozice.

Viz také

Platí pro