ListView.ListViewItemCollection 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

表示 ListView 控件中的或分配给 ListViewGroup 的项的集合。

public: ref class ListView::ListViewItemCollection : System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class ListView.ListViewItemCollection : System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type ListView.ListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class ListView.ListViewItemCollection
Implements IList

继承

Object

ListView.ListViewItemCollection

属性

ListBindableAttribute

实现

ICollection IEnumerable IList

示例

下面的代码示例演示如何将项添加到 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 内ListView.ListViewItemCollection选择了哪些索引。 除了选择集合类之外，还有两个类可用于确定当控件的 ListView 属性设置为true此集合中的) 时CheckBoxes (检查哪些项。

有多种方法可将项添加到集合中。 方法 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)	从集合中移除指定的项。

扩展方法

另请参阅

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection