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 , что ListView1 свойство объекта имеет ListView.ListViewItemCollectionтип.Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. Чтобы выполнить этот пример, вставьте следующий код ListView в форму, содержащую объект с именем ListView1 и TextBox с именем TextBox1.To run this example, paste the following code into a form that contains a ListView object named ListView1 and a TextBox named TextBox1. Вызовите Load метод из конструктора формы или обработчика событий. InitializeListViewCall 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.SelectedIndexCollection ListView ListView ListView.ListViewItemCollection Класс предоставляет свойства и методы для определения того, какие элементы выбраны в элементе управления, а класс позволяет определить, какие индексы в элементе управления 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) в пределах данной коллекции.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. Метод позволяет удалить все элементы из коллекции, а не 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)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к

Дополнительно