ListView.ListViewItemCollection Класс

Определение

Представляет коллекцию элементов в элементе управления ListView или назначенных 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 . Обратите внимание, что Items свойство объекта ListView1 имеет тип ListView.ListViewItemCollection . Чтобы выполнить этот пример, вставьте следующий код в форму, содержащую ListView объект с именем ListView1 и TextBox с именем TextBox1 . Вызовите InitializeListView метод из конструктора формы или Load обработчика событий.

// 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 . В классе определены две другие коллекции ListView , которые позволяют определить, какие элементы выбраны в ListView элементе управления. ListView.SelectedListViewItemCollectionКласс предоставляет свойства и методы для определения того, какие элементы выбраны в ListView элементе управления, а ListView.SelectedIndexCollection класс позволяет определить, какие индексы в элементе ListView.ListViewItemCollection ListView управления выбраны. Помимо классов коллекций выбора, существуют два класса, которые позволяют определить, какие элементы проверяются (если CheckBoxes свойство ListView элемента управления имеет значение true ) в пределах данной коллекции.

Существует несколько способов добавления элементов в коллекцию. AddМетод добавляет один элемент в коллекцию. Чтобы добавить в коллекцию несколько элементов, создайте массив элементов и передайте его в AddRange метод. Если необходимо вставить элемент в определенное место в коллекции, можно использовать Insert метод. Чтобы удалить элементы, можно использовать Remove метод или RemoveAt метод, если известно, где находится элемент в коллекции. ClearМетод позволяет удалить все элементы из коллекции, а не использовать Remove метод для удаления одного элемента за раз.

Помимо методов и свойств для добавления и удаления элементов, объект ListView.ListViewItemCollection также предоставляет методы для поиска элементов в коллекции. ContainsМетод позволяет определить, является ли элемент членом коллекции. Когда вы узнаете, что элемент находится в коллекции, можно использовать IndexOf метод, чтобы определить, где находится элемент в коллекции.

Конструкторы

ListView.ListViewItemCollection(ListView)

Инициализирует новый экземпляр класса ListView.ListViewItemCollection.

Свойства

Count

Возвращает количество элементов в коллекции.

IsReadOnly

Возвращает значение, указывающее, является ли коллекция доступной только для чтения.

Item[Int32]

Получает или задает элемент, расположенный в коллекции по указанному индексу.

Item[String]

Извлекает элемент с заданным ключом.

Методы

Add(ListViewItem)

Добавляет существующий ListViewItem в коллекцию.

Add(String)

Создает элемент с заданным текстом и добавляет его в коллекцию.

Add(String, Int32)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.

Add(String, String)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.

Add(String, String, Int32)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.

Add(String, String, String)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.

AddRange(ListView+ListViewItemCollection)

Добавляет коллекцию элементов в коллекцию.

AddRange(ListViewItem[])

Добавляет в коллекцию массив объектов ListViewItem.

Clear()

Удаляет все элементы из коллекции.

Contains(ListViewItem)

Определяет, находится ли указанный элемент в коллекции.

ContainsKey(String)

Определяет, содержится ли в коллекции элемент с указанным ключом.

CopyTo(Array, Int32)

Копирует коллекцию целиком в заданное место существующего массива.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Find(String, Boolean)

Выполняет поиск элементов, имена которых соответствуют заданному ключу. Поиск может выполняться по вложенным элементам.

GetEnumerator()

Возвращает перечислитель для перебора элементов коллекции.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
IndexOf(ListViewItem)

Возвращает индекс указанного элемента в коллекции.

IndexOfKey(String)

Извлекает индекс элемента с заданным ключом.

Insert(Int32, ListViewItem)

Вставляет существующий ListViewItem в коллекцию по указанному индексу.

Insert(Int32, String)

Создает новый элемент и вставляет его в коллекцию по указанному индексу.

Insert(Int32, String, Int32)

Создает новый элемент с заданным индексом изображения и вставляет его в коллекцию по указанному индексу.

Insert(Int32, String, String)

Создает новый элемент с заданным текстом и изображением и вставляет его в коллекцию по указанному индексу.

Insert(Int32, String, String, Int32)

Создает новый элемент с заданным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.

Insert(Int32, String, String, String)

Создает новый элемент с заданным ключом, текстом и изображением и добавляет его в коллекцию по указанному индексу.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
Remove(ListViewItem)

Удаляет заданный элемент из коллекции.

RemoveAt(Int32)

Удаляет из коллекции элемент по указанному индексу.

RemoveByKey(String)

Удаляет элемент с заданным ключом из коллекции.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Явные реализации интерфейса

ICollection.IsSynchronized

Возвращает значение, указывающее, является ли доступ к коллекции синхронизированным (потокобезопасным).

ICollection.SyncRoot

Возвращает объект, который может быть использован для синхронизации доступа к коллекции элементов управления.

IList.Add(Object)

Добавляет существующий объект в коллекцию.

IList.Contains(Object)

Определяет, содержит ли коллекция заданный элемент.

IList.IndexOf(Object)

Возвращает индекс указанного элемента в коллекции.

IList.Insert(Int32, Object)

Вставляет объект в коллекцию по указанному индексу.

IList.IsFixedSize

Возвращает значение, указывающее, имеет ли коллекция фиксированный размер.

IList.Item[Int32]

Получает или задает значение в коллекции ListViewItem по указанному индексу в коллекции.

IList.Remove(Object)

Удаляет заданный элемент из коллекции.

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.

AsQueryable(IEnumerable)

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

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

См. также раздел