ListView.ListViewItemCollection 클래스

정의

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
public class ListView.ListViewItemCollection : System.Collections.IList
[<System.ComponentModel.ListBindable(false)>]
type ListView.ListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
type ListView.ListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class ListView.ListViewItemCollection
Implements IList
상속
ListView.ListViewItemCollection
특성
구현

예제

다음 코드 예제에서는에 항목을 추가 하는 방법을 보여 줍니다 ListView.ListViewItemCollection .The following code example demonstrates how to add items to a ListView.ListViewItemCollection. Items의 속성 ListView1 은 형식입니다 ListView.ListViewItemCollection .Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. 이 예제를 실행 하려면 라는 개체가 포함 된 폼에 다음 코드를 붙여넣고 ListView 이름이 인 ListView1 TextBox TextBox1To 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 컨트롤에 표시 되거나에 할당 된 항목을 저장 합니다 ListView ListViewGroup .A ListView.ListViewItemCollection stores the items displayed in a ListView control or assigned to a ListViewGroup. ListView컨트롤 내에서 선택 된 항목을 확인할 수 있도록 하는 클래스 내에 정의 된 다른 두 컬렉션이 있습니다 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.SelectedListViewItemCollection클래스는 컨트롤에서 선택 된 항목을 확인 하기 위한 속성 및 메서드 ListView 를 제공 하는 반면, ListView.SelectedIndexCollection 클래스를 사용 하면 선택 된 컨트롤 내의 인덱스를 결정할 수 있습니다 ListView.ListViewItemCollection ListView .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 .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메서드는 컬렉션에 단일 항목을 추가 합니다.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. 메서드를 Clear 사용 하 여 메서드를 사용 하는 대신 컬렉션에서 모든 항목을 제거 하 여 한 번 Remove 에 단일 항목을 제거할 수 있습니다.The 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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ListView.ListViewItemCollection class.

속성

Count

컬렉션의 항목 수를 가져옵니다.Gets the number of items in the collection.

IsReadOnly

컬렉션이 읽기 전용인지를 나타내는 값을 가져옵니다.Gets a value indicating whether the collection is read-only.

Item[Int32]

컬렉션 내의 지정된 인덱스에 있는 항목을 가져오거나 설정합니다.Gets or sets the item at the specified index within the collection.

Item[String]

지정된 키를 가진 항목을 검색합니다.Retrieves the item with the specified key.

메서드

Add(ListViewItem)

기존 ListViewItem을 컬렉션에 추가합니다.Adds an existing ListViewItem to the collection.

Add(String)

지정된 텍스트를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and adds it to the collection.

Add(String, Int32)

지정된 텍스트와 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and image and adds it to the collection.

Add(String, String)

지정된 텍스트와 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and image and adds it to the collection.

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)

지정된 키, 텍스트 및 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified key, text, and image, and adds it to the collection.

AddRange(ListView+ListViewItemCollection)

항목의 컬렉션을 컬렉션에 추가합니다.Adds a collection of items to the collection.

AddRange(ListViewItem[])

컬렉션에 ListViewItem 개체 배열을 추가합니다.Adds an array of ListViewItem objects to the collection.

Clear()

컬렉션에서 모든 항목을 제거합니다.Removes all items from the collection.

Contains(ListViewItem)

지정된 항목이 컬렉션에 있는지 여부를 확인합니다.Determines whether the specified item is located in the collection.

ContainsKey(String)

컬렉션에 지정된 키를 가진 항목이 포함되어 있는지 여부를 확인합니다.Determines whether the collection contains an item with the specified key.

CopyTo(Array, Int32)

배열 내의 지정된 위치에서 기존 배열로 전체 컬렉션을 복사합니다.Copies the entire collection into an existing array at a specified location within the array.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
Find(String, Boolean)

지정된 키와 이름이 일치하는 항목을 검색합니다. 선택적으로 하위 항목을 검색할 수 있습니다.Searches for items whose name matches the specified key, optionally searching subitems.

GetEnumerator()

항목 컬렉션을 반복하는 데 사용할 열거자를 반환합니다.Returns an enumerator to use to iterate through the item collection.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
IndexOf(ListViewItem)

지정된 항목의 컬렉션 내에 있는 인덱스를 반환합니다.Returns the index within the collection of the specified item.

IndexOfKey(String)

지정된 키를 가진 항목의 인덱스를 검색합니다.Retrieves the index of the item with the specified key.

Insert(Int32, ListViewItem)

기존 ListViewItem을 컬렉션의 지정한 인덱스에 삽입합니다.Inserts an existing ListViewItem into the collection at the specified index.

Insert(Int32, String)

새 항목을 만들어 컬렉션의 지정한 인덱스에 삽입합니다.Creates a new item and inserts it into the collection at the specified index.

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)

지정된 텍스트와 이미지를 사용하여 새 항목을 만든 다음 컬렉션의 지정된 인덱스에 삽입합니다.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)

지정된 키, 텍스트 및 이미지를 사용하여 새 항목을 만든 다음 컬렉션의 지정된 인덱스에 삽입합니다.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)

지정된 키, 텍스트 및 이미지를 사용하여 새 항목을 만든 다음 컬렉션의 지정된 인덱스에 추가합니다.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
Remove(ListViewItem)

컬렉션에서 지정한 항목을 제거합니다.Removes the specified item from the collection.

RemoveAt(Int32)

컬렉션 내의 지정된 인덱스에 있는 항목을 제거합니다.Removes the item at the specified index within the collection.

RemoveByKey(String)

지정된 키를 가진 항목을 컬렉션에서 제거합니다.Removes the item with the specified key from the collection.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

ICollection.IsSynchronized

해당 컬렉션에 대한 액세스가 동기화되어 스레드로부터 안전하게 보호되는지를 나타내는 값을 가져옵니다.Gets a value indicating whether access to the collection is synchronized (thread safe).

ICollection.SyncRoot

컨트롤 컬렉션에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.Gets an object that can be used to synchronize access to the collection of controls.

IList.Add(Object)

컬렉션에 기존 개체를 추가합니다.Adds an existing object to the collection.

IList.Contains(Object)

지정한 항목이 컬렉션에 있는지를 확인합니다.Determines whether the specified item is in the collection.

IList.IndexOf(Object)

지정된 항목의 컬렉션 내에 있는 인덱스를 반환합니다.Returns the index within the collection of the specified item.

IList.Insert(Int32, Object)

컬렉션의 지정된 인덱스에 개체를 삽입합니다.Inserts an object into the collection at the specified index.

IList.IsFixedSize

컬렉션의 크기가 고정되어 있는지를 나타내는 값을 가져옵니다.Gets a value indicating whether the collection has a fixed size.

IList.Item[Int32]

컬렉션 내의 지정된 인덱스에 있는 ListViewItem을 가져오거나 설정합니다.Gets or sets the ListViewItem at the specified index within the collection.

IList.Remove(Object)

컬렉션에서 지정한 항목을 제거합니다.Removes the specified item from the collection.

확장 메서드

Cast<TResult>(IEnumerable)

IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

쿼리를 병렬화할 수 있도록 합니다.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable로 변환합니다.Converts an IEnumerable to an IQueryable.

적용 대상

추가 정보