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
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. ListView1Items 속성은 ListView.ListViewItemCollection형식입니다.Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. 이 예제를 실행 하려면 ListView1 이라는 ListView 개체가 포함 된 폼에 다음 코드를 붙여넣고 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. 폼의 생성자 또는 Load 이벤트 처리기에서 InitializeListView 메서드를 호출 합니다.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 컨트롤의 ListView.ListViewItemCollection에서 선택 된 인덱스를 확인할 수 있습니다.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. 선택 컬렉션 클래스 외에도이 컬렉션 내에서 선택 된 항목 (ListView 컨트롤의 CheckBoxes 속성이 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()

현재 개체를 나타내는 string을 반환합니다.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.

적용 대상

추가 정보