ListView.SelectedListViewItemCollection クラス


リスト ビュー コントロールにある、選択された項目のコレクションを表します。Represents the collection of selected items in a list view control.

public: ref class ListView::SelectedListViewItemCollection : System::Collections::IList
public class ListView.SelectedListViewItemCollection : System.Collections.IList
type ListView.SelectedListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class ListView.SelectedListViewItemCollection
Implements IList

次のコードSelectedItems例では、、 SelectedIndexChangedイベントListView.SelectedListViewItemCollection 、メンバー HeaderStyle 、およびクラスを使用する方法を示します。The following code example demonstrates using the SelectedItems, SelectedIndexChanged event, and HeaderStyle members and the ListView.SelectedListViewItemCollection class. この例を実行するにはListView 、という名前ListView1のオブジェクトとという名前TextBox1のをTextBox含むフォームに次のコードを貼り付けます。To run this example, paste the following code in a form that contains a ListView object named ListView1 and a TextBox named TextBox1. フォームのInitializeListViewコンストラクター Loadまたはイベントハンドラーからメソッドを呼び出します。Call the InitializeListView method from the form's constructor or the Load event handler. この例では、イベントハンドラーがSelectedIndexChangedイベントに正しく関連付けられている必要があります。This example requires that the event handler is correctly associated with the SelectedIndexChanged event

// 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 );
  // 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;


      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]);
' 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

    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))
End Sub
// 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();
// 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 = 
    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();
' 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 = _
    Dim item As ListViewItem
    Dim price As Double = 0.0
    For Each item In breakfast
        price += Double.Parse(item.SubItems(1).Text)

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


ListView.SelectedListViewItemCollection 、選択された項目ListViewをコントロールに格納します。A ListView.SelectedListViewItemCollection stores the selected items in a ListView control. に格納さListView.SelectedListViewItemCollectionれている項目はListView.ListViewItemCollection、に格納されている項目です。The items stored in the ListView.SelectedListViewItemCollection are items contained in the ListView.ListViewItemCollection. ListView.ListViewItemCollectionListViewに表示されるすべての項目を格納します。The ListView.ListViewItemCollection stores all items displayed in the ListView.

次の表は、の項目ListView.ListViewItemCollection ListViewとその選択状態をサンプルListViewコントロールに格納する方法の例を示しています。The following table shows an example of how the ListView.ListViewItemCollection stores the items of the ListView as well as their selection states in an example ListView control.

インデックスIndex アイテムItem ListView の選択状態Selection state in the ListView
00 Item1Item1 未選択Unselected
11 Item2Item2 選択済みSelected
22 Item3Item3 未選択Unselected
33 Tuple.item4Item4 選択済みSelected
44 Tuple.item5Item5 選択済みSelected

次の表ListView.ListViewItemCollectionは、前の表の例に基づいて、がListView.SelectedListViewItemCollectionどのように表示されるかを示しています。Based on the ListView.ListViewItemCollection example in the previous table, the following table demonstrates how the ListView.SelectedListViewItemCollection would appear.

インデックスIndex ListViewItemCollection で選択された項目Selected item in the ListViewItemCollection
00 Item2Item2
11 Tuple.item4Item4
22 Tuple.item5Item5

このクラスのプロパティとメソッドを使用して、コレクションに対してさまざまなタスクを実行できます。You can use the properties and methods of this class to perform a variety of tasks with the collection. メソッドを使用すると、 ListView.ListViewItemCollection ListView.SelectedListViewItemCollectionクラスの項目がのメンバーであるかどうかを判断できます。 ContainsThe Contains method enables you to determine whether an item from the ListView.ListViewItemCollection class is a member of the ListView.SelectedListViewItemCollection. 項目がコレクション内にあることを確認したら、 IndexOfメソッドを使用して、 ListView.SelectedListViewItemCollection内の項目の位置を確認できます。Once you know that the item is in the collection, you can use the IndexOf method to determine the position of the item in the ListView.SelectedListViewItemCollection.



ListView.SelectedListViewItemCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the ListView.SelectedListViewItemCollection class.



コレクション内の項目の数を取得します。Gets the number of items in the collection.


コレクションが読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the collection is read-only.


コレクション内の指定したインデックスにある項目を取得します。Gets the item at the specified index within the collection.


指定したキーを持つ項目をコレクションから取得します。Gets an item with the specified key from the collection.



コレクションからすべての項目を削除します。Removes all items from the collection.


指定した項目がコレクション内にあるかどうかを判断します。Determines whether the specified item is located in the collection.


指定したキーの項目がコレクション内にあるかどうかを判断します。Determines whether an item with the specified key is contained in the collection.

CopyTo(Array, Int32)

コレクション全体を既存の配列内の指定した位置にコピーします。Copies the entire collection into an existing array at a specified location within the array.


指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)

選択されている項目のコレクションを反復処理するために使用できる列挙子を返します。Returns an enumerator that can be used to iterate through the selected item collection.


既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)

指定した項目のコレクション内のインデックスを返します。Returns the index within the collection of the specified item.


指定したキーを持つ項目が最初に見つかった位置のインデックスを返します。Returns the index of the first occurrence of the item with the specified key.


現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)



コレクションへのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。Gets a value indicating whether access to the collection is synchronized (thread safe).


コントロールのコレクションへのアクセスを同期するために使用するオブジェクトを取得します。Gets an object that can be used to synchronize access to the collection of controls.


項目をコレクションに追加します。Adds an item to the collection.


指定した項目がコレクション内にあるかどうかを判断します。Determines whether the specified item is located in the collection.


指定した項目のコレクション内のインデックスを返します。Returns the index, within the collection, of the specified item.

IList.Insert(Int32, Object)

コレクション内の指定したインデックスの位置に項目を挿入します。Inserts an item into the collection at a specified index.


コレクションが固定サイズかどうかを示す値を取得します。Gets a value indicating whether the collection has a fixed size.


コレクションからオブジェクトを取得または設定します。Gets or sets an object from the collection.


指定した項目のうち最初に見つかった項目をコレクションから削除します。Removes the first occurrence of a specified item from the collection.


コレクション内の指定したインデックスの項目を削除します。Removes an item from the collection at a specified index.



IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.


指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.


クエリの並列化を有効にします。Enables parallelization of a query.


IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.