ListViewに項目を追加する - C#

リストビューに項目を追加するコードを紹介します。

概要

リストビューに項目を追加するには、ListViewItemオブジェクトを作成し、 ItemsオブジェクトのAddメソッドを呼び出してリストビューに追加します。

プログラム

UIの準備

下図のフォームを作成します。ボタンを2つ、複数行のテキストボックスを1つ配置します。(今回の例ではボタンは1つのみ利用します。)

フォームデザイナでListViewをクリックして選択します。プロパティウィンドウの[View]プロパティを変更します。デフォルトは"LargeIcon"が設定されています。

プロパティの値のコンボボックスをクリックします。ドロップダウンリストから"Details"の項目をクリックして選択します。

Viewプロパティの値が、"Details"になりました。リストビューのカラムのヘッダが表示されます。

続いてカラムを設定します。[Columns]プロパティの値の右側の[...]ボタンをクリックします。

[ColumnHeader コレクションエディター]のウィンドウが表示されます。

ウィンドウ左下の[追加]ボタンをクリックします。クリックするとヘッダの項目が追加されます。ボタンを3回クリックして、カラムのヘッダ項目を4つにします。

フォームデザイナに戻ると、カラムが4つになりました。

コード

以下のコードを記述します。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace ListViewDemo
{
  public partial class FormAddDelete : Form
  {
    public FormAddDelete()
    {
      InitializeComponent();
    }

    private void button1_Click(object sender, EventArgs e)
    {
      ListViewItem lvi = new ListViewItem();
      lvi.Text = "ぺんぎんクッキー";
      lvi.SubItems.Add("420");
      lvi.SubItems.Add("18");
      lvi.SubItems.Add("サクサクしたクッキーです。");
      listView1.Items.Add(lvi);

      lvi = new ListViewItem();
      lvi.Text = "らくだキャラメル";
      lvi.SubItems.Add("220");
      lvi.SubItems.Add("16");
      lvi.SubItems.Add("まったりした味わいのキャラメルです。");
      listView1.Items.Add(lvi);

      lvi = new ListViewItem();
      lvi.Text = "かるがもタルト";
      lvi.SubItems.Add("390");
      lvi.SubItems.Add("33");
      lvi.SubItems.Add("濃厚な風味のタルトです。");
      listView1.Items.Add(lvi);
    }


  }
}

解説

ListViewImteオブジェクトを作成します。

  ListViewItem lvi = new ListViewItem();

Textプロパティに値を代入します。Textプロパティの値が最初のカラムの値になります。

  lvi.Text = "ぺんぎんクッキー";

SubItems.Addメソッドを呼び出し、SubItemを追加します。Addメソッドの引数にSubItemの値を与えます。この値が、2番目以降のカラムの値になります。

  lvi.SubItems.Add("420");
  lvi.SubItems.Add("18");
  lvi.SubItems.Add("サクサクしたクッキーです。");

ListViewのItemsプロパティのAddメソッドを呼び出し、ListViewに項目を追加します。AddメソッドのパラメーターにListViewItemオブジェクトを与えます。

  listView1.Items.Add(lvi);

参考

同じ処理を以下のコードで記述することもできます。
ListViewItemのコンストラクタに配列を与えると、SubItemsの作成をコンストラクタの処理でできます。

  private void button1_Click(object sender, EventArgs e)
  {
    listView1.Items.Add(new ListViewItem(new[] { "ぺんぎんクッキー", "420", "18", "サクサクしたクッキーです。" }));
    listView1.Items.Add(new ListViewItem(new[] { "らくだキャラメル", "220", "16", "まったりした味わいのキャラメルです。" }));
    listView1.Items.Add(new ListViewItem(new[] { "かるがもタルト", "390", "33", "濃厚な風味のタルトです。" }));
  }