ListView.ListViewItemCollection.AddRange メソッド

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

コレクションに項目の配列を追加します。

オーバーロード

AddRange(ListView+ListViewItemCollection)	項目のコレクションをコレクションに追加します。
AddRange(ListViewItem[])	コレクションに ListViewItem オブジェクトの配列を追加します。

AddRange(ListView+ListViewItemCollection)

項目のコレクションをコレクションに追加します。

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)

パラメーター

items: ListView.ListViewItemCollection

コレクションに追加する ListView.ListViewItemCollection。

例外

ArgumentNullException

items が nullです。

InvalidOperationException

格納先の ListView が仮想モードです。

注釈

を ListView 含むが並べ替えられた場合、 AddRange メソッドは並べ替えられた順序で項目を追加します。それ以外の場合は、コレクションの末尾に項目を追加します。

適用対象

AddRange(ListViewItem[])

コレクションに ListViewItem オブジェクトの配列を追加します。

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

パラメーター

valuesitems: ListViewItem[]

コレクションに追加する ListViewItem オブジェクトの配列。

例外

ArgumentNullException

items が nullです。

例

次の例では、3 つのListViewItemオブジェクトをListView指定し、項目ごとに 3 つのListViewItem.ListViewSubItemオブジェクトを指定してコントロールを作成します。この例では、詳細ビューにサブ項目を表示するオブジェクトも作成 ColumnHeader します。コード例では、オブジェクトのイメージListViewItemを提供するために、2 つのImageListオブジェクトも作成されます。これらのImageListオブジェクトは、プロパティと SmallImageList プロパティにLargeImageList追加されます。この例では、コントロールの作成に次のプロパティを ListView 使用します。

この例では、にコード Form を追加し、この例で作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出す必要があります。この例では、という名前MySmallImage1MySmallImage2MyLargeImage1MyLargeImage2のイメージがドライブ 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 のコントロールの項目を再利用できます。 1 つ ListViewItemを追加する場合は、メソッドを使用します Add 。コレクション内の特定の Insert 位置に 1 つ ListViewItem を追加する場合は、メソッドを使用することもできます。

また、このメソッドを使用して、に複数の ListViewItem オブジェクトを ListViewGroup割り当てることもできます。

プロパティが以外SortOrder.NoneのListView.Sorting値に設定されている場合、またはプロパティがListViewItemSorter設定されている場合は、項目が追加された後にリストが並べ替えられます。それ以外の場合、項目はリストの末尾に挿入されます。リストが並べ替えされていない場合は、メソッドを Insert 使用して、特定の位置にあるに項目を ListView 挿入できます。

こちらもご覧ください

適用対象

次の方法で共有

ListView.ListViewItemCollection.AddRange メソッド

定義

オーバーロード

AddRange(ListView+ListViewItemCollection)

パラメーター

例外

注釈

適用対象

AddRange(ListViewItem[])

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース