ListView.ListViewItemCollection.AddRange Methode

Definitie

Naamruimte:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Voegt een matrix met items toe aan de verzameling.

Overloads

Name	Description
AddRange(ListView+ListViewItemCollection)	Hiermee voegt u een verzameling items toe aan de verzameling.
AddRange(ListViewItem[])	Hiermee voegt u een matrix met ListViewItem objecten toe aan de verzameling.

AddRange(ListView+ListViewItemCollection)

Bron:: ListView.ListViewItemCollection.cs

Bron:: ListView.ListViewItemCollection.cs

Bron:: ListView.ListViewItemCollection.cs

Bron:: ListView.ListViewItemCollection.cs

Bron:: ListView.ListViewItemCollection.cs

Hiermee voegt u een verzameling items toe aan de verzameling.

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)

Parameters

items: ListView.ListViewItemCollection

De ListView.ListViewItemCollection toe te voegen aan de verzameling.

Uitzonderingen

ArgumentNullException

items is null.

InvalidOperationException

Het bevat ListView zich in de virtuele modus.

Opmerkingen

Als de inhoud ListView is gesorteerd, voegt de AddRange methode de items in de gesorteerde volgorde toe. Anders worden ze aan het einde van de verzameling toegevoegd.

Van toepassing op

AddRange(ListViewItem[])

Bron:: ListView.ListViewItemCollection.cs

Bron:: ListView.ListViewItemCollection.cs

Bron:: ListView.ListViewItemCollection.cs

Bron:: ListView.ListViewItemCollection.cs

Bron:: ListView.ListViewItemCollection.cs

Hiermee voegt u een matrix met ListViewItem objecten toe aan de verzameling.

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())

Parameters

valuesitems: ListViewItem[]

Een matrix met ListViewItem objecten die aan de verzameling moeten worden toegevoegd.

Uitzonderingen

ArgumentNullException

items is null.

Voorbeelden

In het volgende voorbeeld wordt een ListView besturingselement gemaakt met drie ListViewItem opgegeven objecten en drie ListViewItem.ListViewSubItem objecten die voor elk item zijn opgegeven. In het voorbeeld worden ook objecten gemaakt ColumnHeader om de subitems weer te geven in de detailweergave. Er worden ook twee ImageList objecten gemaakt in het codevoorbeeld om afbeeldingen voor de ListViewItem objecten te bieden. Deze ImageList objecten worden toegevoegd aan de LargeImageList en SmallImageList eigenschappen. In het voorbeeld worden de volgende eigenschappen gebruikt bij het maken van het ListView besturingselement:

Voor dit voorbeeld moet u de code hebben toegevoegd aan een Form en de methode hebt aangeroepen die in het voorbeeld is gemaakt vanuit de constructor of een andere methode in het formulier. Het voorbeeld vereist ook dat installatiekopieën met de naam MySmallImage1, MySmallImage2en MyLargeImage1MyLargeImage2 zich bevinden in de hoofdmap van station 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

Opmerkingen

U kunt deze methode gebruiken om items uit een ander ListView besturingselement opnieuw te gebruiken. Als u één ListViewItemwilt toevoegen, gebruikt u de Add methode. U kunt de Insert methode ook gebruiken als u één ListViewItem wilt toevoegen op een specifieke positie in de verzameling.

U kunt deze methode ook gebruiken om meerdere ListViewItem objecten toe te wijzen aan een ListViewGroup.

Als de ListView.Sorting eigenschap is ingesteld op een andere waarde dan SortOrder.None of als de ListViewItemSorter eigenschap is ingesteld, wordt de lijst gesorteerd nadat de items zijn toegevoegd. Anders worden de items aan het einde van de lijst ingevoegd. Als de lijst niet is gesorteerd, kunt u de Insert methode gebruiken om items in de ListView specifieke posities in te voegen.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?