ListView.ListViewItemCollection ListView.ListViewItemCollection ListView.ListViewItemCollection ListView.ListViewItemCollection Class

定義

ListView コントロールに表示される項目のコレクション、または ListViewGroup に割り当てられた項目のコレクションを表します。Represents the collection of items in a ListView control or assigned to a ListViewGroup.

public: ref class ListView::ListViewItemCollection : System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class ListView.ListViewItemCollection : System.Collections.IList
type ListView.ListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class ListView.ListViewItemCollection
Implements IList
継承
ListView.ListViewItemCollectionListView.ListViewItemCollectionListView.ListViewItemCollectionListView.ListViewItemCollection
属性
実装

次のコード例は、 ListView.ListViewItemCollectionに項目を追加する方法を示しています。The following code example demonstrates how to add items to a ListView.ListViewItemCollection. Items ListView.ListViewItemCollectionプロパティが型であることに注意してください。 ListView1Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. この例を実行するにはListView 、という名前ListView1のオブジェクトとという名前TextBox1のをTextBox含むフォームに、次のコードを貼り付けます。To run this example, paste the following code into 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 Load event handler.

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

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

注釈

ListView.ListViewItemCollection ListViewListViewGroupコントロールに表示される項目またはに割り当てられた項目を格納します。A ListView.ListViewItemCollection stores the items displayed in a ListView control or assigned to a ListViewGroup. ListViewクラス内で定義されている他の2つのコレクションにより、 ListViewコントロール内で選択された項目を判別できます。There are two other collections defined within the ListView class that enable you to determine what items are selected within a ListView control. ListView ListView.SelectedIndexCollection ListView.ListViewItemCollectionクラスには、コントロールで選択される項目を決定ListViewするためのプロパティとメソッドが用意されています。また、クラスを使用すると、コントロールの内のインデックスを確認できます。 ListView.SelectedListViewItemCollectionオフ.The ListView.SelectedListViewItemCollection class provides properties and methods for determining what items are selected in a ListView control, while the ListView.SelectedIndexCollection class enables you to determine what indexes within the ListView.ListViewItemCollection of a ListView control are selected. 選択コレクションクラスに加えて、このコレクション内でチェックされる項目 ( CheckBoxes ListViewコントロールのプロパティがにtrue設定されている場合) を決定できる2つのクラスもあります。In addition to selection collection classes, there are also two classes that enable you to determine what items are checked (when the CheckBoxes property of the ListView control is set to true) within this collection.

コレクションに項目を追加するには、いくつかの方法があります。There are a number of ways to add items to the collection. メソッドAddは、コレクションに1つの項目を追加します。The Add method adds a single item to the collection. コレクションに複数の項目を追加するには、項目の配列を作成して、 AddRangeメソッドに渡します。To add a number of items to the collection, you create an array of items and pass it to the AddRange method. コレクション内の特定の位置に項目を挿入する場合は、 Insertメソッドを使用できます。If you want to insert an item at a specific location in the collection, you can use the Insert method. 項目を削除するには、コレクション内Removeの項目のRemoveAt位置がわかっている場合は、メソッドまたはメソッドのいずれかを使用できます。To remove items, you can use either the Remove method or the RemoveAt method if you know where the item is located in the collection. メソッドを使用すると、メソッドを使用して一度に1つの項目を削除する代わりに、コレクションからすべての項目を削除できます。 Remove ClearThe Clear method enables you to remove all items from the collection instead of using the Remove method to remove a single item at a time.

にはListView.ListViewItemCollection 、項目を追加および削除するためのメソッドとプロパティに加えて、コレクション内の項目を検索するメソッドも用意されています。In addition to methods and properties for adding and removing items, the ListView.ListViewItemCollection also provides methods to find items in the collection. Containsメソッドを使用すると、項目がコレクションのメンバーであるかどうかを判断できます。The Contains method enables you to determine whether an item is a member of the collection. コレクション内に項目があることを確認したら、 IndexOfメソッドを使用して、コレクション内の項目の位置を確認できます。Once you know that the item is located in the collection, you can use the IndexOf method to determine where the item is located in the collection.

コンストラクター

ListView.ListViewItemCollection(ListView) ListView.ListViewItemCollection(ListView) ListView.ListViewItemCollection(ListView) ListView.ListViewItemCollection(ListView)

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

プロパティ

Count Count Count Count

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

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

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

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

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

Item[String] Item[String] Item[String] Item[String]

指定したキーを持つ項目を取得します。Retrieves the item with the specified key.

メソッド

Add(ListViewItem) Add(ListViewItem) Add(ListViewItem) Add(ListViewItem)

既存の ListViewItem をコレクションに追加します。Adds an existing ListViewItem to the collection.

Add(String) Add(String) Add(String) Add(String)

指定したテキストを使用して項目を作成し、コレクションに追加します。Creates an item with the specified text and adds it to the collection.

Add(String, Int32) Add(String, Int32) Add(String, Int32) Add(String, Int32)

指定したテキストとイメージを使用して項目を作成し、コレクションに追加します。Creates an item with the specified text and image and adds it to the collection.

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

指定したテキストとイメージを使用して項目を作成し、コレクションに追加します。Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32) Add(String, String, Int32) Add(String, String, Int32) Add(String, String, Int32)

指定したキー、テキスト、およびイメージを使用して項目を作成し、コレクションに追加します。Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String) Add(String, String, String) Add(String, String, String) Add(String, String, String)

指定したキー、テキスト、およびイメージを使用して項目を作成し、コレクションに追加します。Creates an item with the specified key, text, and image, and adds it to the collection.

AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection)

項目のコレクションをコレクションに追加します。Adds a collection of items to the collection.

AddRange(ListViewItem[]) AddRange(ListViewItem[]) AddRange(ListViewItem[]) AddRange(ListViewItem[])

コレクションに ListViewItem オブジェクトの配列を追加します。Adds an array of ListViewItem objects to the collection.

Clear() Clear() Clear() Clear()

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

Contains(ListViewItem) Contains(ListViewItem) Contains(ListViewItem) Contains(ListViewItem)

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

ContainsKey(String) ContainsKey(String) ContainsKey(String) ContainsKey(String)

指定したキーの項目がコレクションに含まれているかどうかを確認します。Determines whether the collection contains an item with the specified key.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Find(String, Boolean) Find(String, Boolean) Find(String, Boolean) Find(String, Boolean)

指定したキーと一致する名前を持つ項目を検索し、オプションでサブ項目も検索します。Searches for items whose name matches the specified key, optionally searching subitems.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

項目コレクションを反復処理するために使用する列挙子を返します。Returns an enumerator to use to iterate through the item collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(ListViewItem) IndexOf(ListViewItem) IndexOf(ListViewItem) IndexOf(ListViewItem)

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

IndexOfKey(String) IndexOfKey(String) IndexOfKey(String) IndexOfKey(String)

指定したキーを持つ項目のインデックスを取得します。Retrieves the index of the item with the specified key.

Insert(Int32, ListViewItem) Insert(Int32, ListViewItem) Insert(Int32, ListViewItem) Insert(Int32, ListViewItem)

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

Insert(Int32, String) Insert(Int32, String) Insert(Int32, String) Insert(Int32, String)

新しい項目を作成し、コレクション内の指定したインデックス位置に挿入します。Creates a new item and inserts it into the collection at the specified index.

Insert(Int32, String, Int32) Insert(Int32, String, Int32) Insert(Int32, String, Int32) Insert(Int32, String, Int32)

指定したイメージのインデックスを使用して新しい項目を作成し、コレクション内の指定したインデックス位置に挿入します。Creates a new item with the specified image index and inserts it into the collection at the specified index.

Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String)

テキストとイメージを指定して新しい項目を作成し、コレクション内の指定したインデックスに挿入します。Creates a new item with the specified text and image and inserts it in the collection at the specified index.

Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32)

キー、テキスト、およびイメージを指定して新しい項目を作成し、コレクション内の指定したインデックスに挿入します。Creates a new item with the specified key, text, and image, and inserts it in the collection at the specified index.

Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String)

キー、テキスト、およびイメージを指定して新しい項目を作成し、コレクション内の指定したインデックスに追加します。Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Remove(ListViewItem) Remove(ListViewItem) Remove(ListViewItem) Remove(ListViewItem)

指定した項目をコレクションから削除します。Removes the specified item from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

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

RemoveByKey(String) RemoveByKey(String) RemoveByKey(String) RemoveByKey(String)

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

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

明示的なインターフェイスの実装

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

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

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

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

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

既存のオブジェクトをコレクションに追加します。Adds an existing object to the collection.

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

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

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

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

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

コレクション内の指定したインデックス位置にオブジェクトを挿入します。Inserts an object into the collection at the specified index.

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

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

IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

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

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

指定した項目をコレクションから削除します。Removes the specified item from the collection.

拡張メソッド

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

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

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

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

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

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

適用対象

こちらもご覧ください