ListView.SelectedListViewItemCollection クラス

.NET Framework クラス ライブラリ リファレンス

ListView.SelectedListViewItemCollection クラス

リスト ビュー コントロールにある、選択された項目のコレクションを表します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class SelectedListViewItemCollection
    Implements IList, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As SelectedListViewItemCollection

C#

public class SelectedListViewItemCollection
 : IList, ICollection, IEnumerable

C++

public ref class SelectedListViewItemCollection
 : IList, ICollection, IEnumerable

J#

public class SelectedListViewItemCollection
 implements IList, ICollection, 
    IEnumerable

JScript

public class SelectedListViewItemCollection
 implements IList, ICollection, 
    IEnumerable

解説

ListView.SelectedListViewItemCollection は ListView コントロールの選択された項目を格納します。ListView.SelectedListViewItemCollection に格納されている項目は、ListView.ListViewItemCollection に格納されている項目です。ListView.ListViewItemCollection は、ListView に表示されるすべての項目を格納します。

ListView の項目が ListView.ListViewItemCollection にどのように格納されているか、およびこの例の ListView コントロール内における項目の選択状態を次の表に示します。

インデックス	項目	ListView での選択の状態
0	Item1	選択されていない
1	Item2	選択されている
2	Item3	選択されていない
3	Item4	選択されている
4	Item5	選択されている

前の表の ListView.ListViewItemCollection の例に基づいた ListView.SelectedListViewItemCollection の内容を次の表に示します。

インデックス	ListViewItemCollection 内の選択された項目
0	Item2
1	Item4
2	Item5

このクラスのプロパティとメソッドを使用すると、コレクションを使用してさまざまなタスクを実行できます。Contains メソッドを使用すると、ListView.ListViewItemCollection クラスの項目が ListView.SelectedListViewItemCollection クラスのメンバかどうかを確認できます。コレクション内に項目があることが判明している場合は、IndexOf メソッドを使用して、ListView.SelectedListViewItemCollection 内の項目の位置を確認できます。

使用例

SelectedItems イベント、SelectedIndexChanged イベント、HeaderStyle のメンバ、および ListView.SelectedListViewItemCollection クラスを使用するコード例を次に示します。この例を実行するには、ListView1 という名前の ListView オブジェクトと TextBox1 という名前の TextBox が配置されているフォームに次のコードを貼り付けます。次に、フォームのコンストラクタまたは Load のイベント ハンドラで InitializeListView メソッドを呼び出します。この例では、イベント ハンドラが SelectedIndexChanged イベントに正しく関連付けられている必要があります。

Visual Basic

    ' This method adds two columns to the ListView, setting the Text 
    ' and TextAlign, and Width properties of each ColumnHeader.  The
 
    ' HeaderStyle property is set to NonClickable since the ColumnClick
 
    ' event is not handled.  Finally the method adds ListViewItems and
 
    ' SubItems to each column.
    Private Sub InitializeListView()
        Me.ListView1 = New System.Windows.Forms.ListView
        Me.ListView1.BackColor = System.Drawing.SystemColors.Control
        Me.ListView1.Dock = System.Windows.Forms.DockStyle.Top
        Me.ListView1.Location = New System.Drawing.Point(0,
 0)
        Me.ListView1.Name = "ListView1"
        Me.ListView1.Size = New System.Drawing.Size(292,
 130)
        Me.ListView1.TabIndex = 0
        Me.ListView1.View = System.Windows.Forms.View.Details
        Me.ListView1.MultiSelect = True
        Me.ListView1.HideSelection = False
        ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable
        Dim columnHeader1 As New
 ColumnHeader
        With columnHeader1
            .Text = "Breakfast Item"
            .TextAlign = HorizontalAlignment.Left
            .Width = 146
        End With
        Dim columnHeader2 As New
 ColumnHeader
        With columnHeader2
            .Text = "Price Each"
            .TextAlign = HorizontalAlignment.Center
            .Width = 142
        End With

        Me.ListView1.Columns.Add(columnHeader1)
        Me.ListView1.Columns.Add(columnHeader2)
        Dim foodList() As String
 = New String() {"Juice",
 "Coffee", _
            "Cereal & Milk", "Fruit
 Plate", "Toast & Jelly", _
            "Bagel & Cream Cheese"}
        Dim foodPrice() As String
 = New String() {"1.09",
 "1.09", _
            "2.19", "2.49",
 "1.49", "1.49"}
        Dim count As Integer
        For count = 0 To foodList.Length -
 1
            Dim listItem As New
 ListViewItem(foodList(count))
            listItem.SubItems.Add(foodPrice(count))
            ListView1.Items.Add(listItem)
        Next
        Me.Controls.Add(Me.ListView1)
    End Sub
<br /><span space="preserve">...</span><br
 />    ' Uses the SelectedItems property to retrieve and tally the
 price 
    ' of the selected menu items.
    Private Sub ListView1_SelectedIndexChanged_UsingItems
 _
        (ByVal sender As Object,
 ByVal e As System.EventArgs) _
        Handles ListView1.SelectedIndexChanged

        Dim breakfast As ListView.SelectedListViewItemCollection
 = _
            Me.ListView1.SelectedItems
        Dim item As ListViewItem
        Dim price As Double
 = 0.0
        For Each item In
 breakfast
            price += Double.Parse(item.SubItems(1).Text)
        Next

        ' Output the price to TextBox1.
        TextBox1.Text = CType(price, String)
    End Sub

C#

    // This method adds two columns to the ListView, setting the Text 
    // and TextAlign, and Width properties of each ColumnHeader.  The
 
    // HeaderStyle property is set to NonClickable since the ColumnClick
 
    // event is not handled.  Finally the method adds ListViewItems
 and 
    // SubItems to each column.
    private void InitializeListView()
    {
        this.ListView1 = new System.Windows.Forms.ListView();
        this.ListView1.BackColor = System.Drawing.SystemColors.Control;
        this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
        this.ListView1.Location = new System.Drawing.Point(0,
 0);
        this.ListView1.Name = "ListView1";
        this.ListView1.Size = new System.Drawing.Size(292,
 130);
        this.ListView1.TabIndex = 0;
        this.ListView1.View = System.Windows.Forms.View.Details;
        this.ListView1.MultiSelect = true;
        this.ListView1.HideSelection = false;
        this.ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
        
        ColumnHeader columnHeader1 = new ColumnHeader();
        columnHeader1.Text = "Breakfast Item";
        columnHeader1.TextAlign = HorizontalAlignment.Left;
        columnHeader1.Width = 146;

         ColumnHeader columnHeader2 = new ColumnHeader();
        columnHeader2.Text = "Price Each";
        columnHeader2.TextAlign = HorizontalAlignment.Center;
        columnHeader2.Width = 142;
  
        this.ListView1.Columns.Add(columnHeader1);
        this.ListView1.Columns.Add(columnHeader2);

        string[] foodList = new string[]{"Juice",
 "Coffee", 
            "Cereal & Milk", "Fruit Plate", "Toast &
 Jelly", 
            "Bagel & Cream Cheese"};
        string[] foodPrice = new string[]{"1.09",
 "1.09", "2.19", 
            "2.49", "1.49", "1.49"};
        
        for(int count=0; count < foodList.Length;
 count++)
        {
            ListViewItem listItem = new ListViewItem(foodList[count]);
            listItem.SubItems.Add(foodPrice[count]);
            ListView1.Items.Add(listItem);
        }
        this.Controls.Add(ListView1);
    }
    
<br /><span space="preserve">...</span><br /> 
   // Uses the SelectedItems property to retrieve and tally the price
 
    // of the selected menu items.
    private void ListView1_SelectedIndexChanged_UsingItems(
        object sender, System.EventArgs e)
    {

        ListView.SelectedListViewItemCollection breakfast = 
            this.ListView1.SelectedItems;
        
        double price = 0.0;
        foreach ( ListViewItem item in breakfast
 )
        {
            price += Double.Parse(item.SubItems[1].Text);
        }

        // Output the price to TextBox1.
        TextBox1.Text = price.ToString();
    }

C++

   // This method adds two columns to the ListView, setting the Text 
   // and TextAlign, and Width properties of each ColumnHeader.  The
 
   // HeaderStyle property is set to NonClickable since the ColumnClick
 
   // event is not handled.  Finally the method adds ListViewItems and
 
   // SubItems to each column.
   void InitializeListView()
   {
      this->ListView1 = gcnew System::Windows::Forms::ListView;
      this->ListView1->BackColor = System::Drawing::SystemColors::Control;
      this->ListView1->Dock = System::Windows::Forms::DockStyle::Top;
      this->ListView1->Location = System::Drawing::Point(
 0, 0 );
      this->ListView1->Name = "ListView1";
      this->ListView1->Size = System::Drawing::Size( 292,
 130 );
      this->ListView1->TabIndex = 0;
      this->ListView1->View = System::Windows::Forms::View::Details;
      this->ListView1->MultiSelect = true;
      this->ListView1->HideSelection = false;
      this->ListView1->HeaderStyle = ColumnHeaderStyle::Nonclickable;
      ColumnHeader^ columnHeader1 = gcnew ColumnHeader;
      columnHeader1->Text = "Breakfast Item";
      columnHeader1->TextAlign = HorizontalAlignment::Left;
      columnHeader1->Width = 146;
      ColumnHeader^ columnHeader2 = gcnew ColumnHeader;
      columnHeader2->Text = "Price Each";
      columnHeader2->TextAlign = HorizontalAlignment::Center;
      columnHeader2->Width = 142;
      this->ListView1->Columns->Add( columnHeader1 );
      this->ListView1->Columns->Add( columnHeader2 );
      array<String^>^foodList = {"Juice","Coffee","Cereal
 & Milk","Fruit Plate","Toast & Jelly","Bagel
 & Cream Cheese"};
      array<String^>^foodPrice = {"1.09","1.09","2.19"
,"2.49","1.49","1.49"};
      for ( int count = 0; count < foodList->Length;
 count++ )
      {
         ListViewItem^ listItem = gcnew ListViewItem( foodList[ count ] );
         listItem->SubItems->Add( foodPrice[ count ] );
         ListView1->Items->Add( listItem );

      }
      this->Controls->Add( ListView1 );
   }
<br /><span space="preserve">...</span><br /> 
  // Uses the SelectedItems property to retrieve and tally the price
 
   // of the selected menu items.
   void ListView1_SelectedIndexChanged_UsingItems( Object^ /*sender*/,
 System::EventArgs^ /*e*/ )
   {
      ListView::SelectedListViewItemCollection^ breakfast = this->ListView1->SelectedItems;
      double price = 0.0;
      System::Collections::IEnumerator^ myEnum = breakfast->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         ListViewItem^ item = safe_cast<ListViewItem^>(myEnum->Current);
         price += Double::Parse( item->SubItems[ 1 ]->Text );
      }

      // Output the price to TextBox1.
      TextBox1->Text = price.ToString();
   }

J#

    // This method adds two columns to the ListView, setting the Text 
    // and TextAlign, and Width properties of each ColumnHeader.  The
 
    // HeaderStyle property is set to NonClickable since the ColumnClick
 
    // event is not handled.  Finally the method adds ListViewItems
 and 
    // SubItems to each column.
    private void InitializeListView()
    {
        this.listView1 = new System.Windows.Forms.ListView();
        this.listView1.set_BackColor(
            System.Drawing.SystemColors.get_Control());
        this.listView1.set_Dock(System.Windows.Forms.DockStyle.Top);
        this.listView1.set_Location(new System.Drawing.Point(0,
 0));
        this.listView1.set_Name("listView1");
        this.listView1.set_Size(new System.Drawing.Size(292,
 130));
        this.listView1.set_TabIndex(0);
        this.listView1.set_View(System.Windows.Forms.View.Details);
        this.listView1.set_MultiSelect(true);
        this.listView1.set_HideSelection(false);
        this.listView1.set_HeaderStyle(ColumnHeaderStyle.Nonclickable);

        ColumnHeader columnHeader1 = new ColumnHeader();
        columnHeader1.set_Text("Breakfast Item");
        columnHeader1.set_TextAlign(HorizontalAlignment.Left);
        columnHeader1.set_Width(146);

        ColumnHeader columnHeader2 = new ColumnHeader();
        columnHeader2.set_Text("Price Each");
        columnHeader2.set_TextAlign(HorizontalAlignment.Center);
        columnHeader2.set_Width(142);

        this.listView1.get_Columns().Add(columnHeader1);
        this.listView1.get_Columns().Add(columnHeader2);

        String foodList[] = new String[] { "Juice",
 "Coffee", "Cereal & Milk",
            "Fruit Plate", "Toast & Jelly", "Bagel &
 Cream Cheese" };
        String foodPrice[] = new String[] { "1.09",
 "1.09", "2.19", "2.49",
            "1.49", "1.49" };

        for (int count = 0; count < foodList.get_Length();
 count++) {
            ListViewItem listItem = new ListViewItem(
                foodList.get_Item(count).ToString());
            listItem.get_SubItems().Add(foodPrice.get_Item(count).ToString());
            listView1.get_Items().Add(listItem);
        }
        this.get_Controls().Add(listView1);
    } //InitializeListView
<br /><span space="preserve">...</span><br /> 
   // Uses the SelectedItems property to retrieve and tally the price
 
    // of the selected menu items.
    private void listView1_SelectedIndexChanged_UsingItems(Object
 sender, 
        System.EventArgs e)
    {
        ListView.SelectedListViewItemCollection breakfast = 
            this.listView1.get_SelectedItems();

        double price = 0.0;
        for (int iCtr = 0; iCtr < breakfast.get_Count();
 iCtr++) {
            ListViewItem item = breakfast.get_Item(iCtr);
            price += System.Double.Parse(item.get_SubItems().get_Item(1).
                get_Text().ToString());
        }
        // Output the price to textBox1.
        textBox1.set_Text(System.Convert.ToString(price));
    } //listView1_SelectedIndexChanged_UsingItems

継承階層

System.Object
  System.Windows.Forms.ListView.SelectedListViewItemCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ListView.SelectedListViewItemCollection メンバ
System.Windows.Forms 名前空間