ListView.ListViewItemCollection Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mewakili kumpulan item dalam ListView kontrol atau ditetapkan ke 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

Warisan

Object

ListView.ListViewItemCollection

Atribut

ListBindableAttribute

Penerapan

ICollection IEnumerable IList

Contoh

Contoh kode berikut menunjukkan cara menambahkan item ke ListView.ListViewItemCollection. Perhatikan bahwa Items properti berjenis ListView1ListView.ListViewItemCollection. Untuk menjalankan contoh ini, tempelkan kode berikut ke dalam formulir yang berisi ListView objek bernama ListView1 dan bernama TextBoxTextBox1. InitializeListView Panggil metode dari konstruktor formulir atau Load penanganan aktivitas.

// 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

Keterangan

Menyimpan ListView.ListViewItemCollection item yang ditampilkan dalam ListView kontrol atau ditetapkan ke ListViewGroup. Ada dua koleksi lain yang ditentukan dalam ListView kelas yang memungkinkan Anda menentukan item apa yang dipilih dalam ListView kontrol. Kelas ListView.SelectedListViewItemCollection menyediakan properti dan metode untuk menentukan item apa yang dipilih dalam ListView kontrol, sementara ListView.SelectedIndexCollection kelas memungkinkan Anda menentukan indeks apa dalam ListView.ListViewItemCollectionListView kontrol yang dipilih. Selain kelas koleksi pilihan, ada juga dua kelas yang memungkinkan Anda menentukan item apa yang dicentang (ketika CheckBoxes properti ListView kontrol diatur ke true) dalam koleksi ini.

Ada sejumlah cara untuk menambahkan item ke koleksi. Metode menambahkan Add satu item ke koleksi. Untuk menambahkan sejumlah item ke koleksi, Anda membuat array item dan meneruskannya ke AddRange metode . Jika Anda ingin menyisipkan item di lokasi tertentu dalam koleksi, Anda dapat menggunakan metode .Insert Untuk menghapus item, Anda dapat menggunakan Remove metode atau RemoveAt metode jika Anda tahu di mana item berada dalam koleksi. Metode ini Clear memungkinkan Anda untuk menghapus semua item dari koleksi alih-alih menggunakan Remove metode untuk menghapus satu item pada satu waktu.

Selain metode dan properti untuk menambahkan dan menghapus item, ListView.ListViewItemCollection juga menyediakan metode untuk menemukan item dalam koleksi. Metode ini Contains memungkinkan Anda menentukan apakah item adalah anggota koleksi. Setelah Anda tahu bahwa item terletak di koleksi, Anda dapat menggunakan IndexOf metode untuk menentukan di mana item berada dalam koleksi.

Konstruktor

ListView.ListViewItemCollection(ListView)

Menginisialisasi instans baru kelas ListView.ListViewItemCollection.

Properti

Count	Mendapatkan jumlah item dalam koleksi.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah koleksi bersifat baca-saja.
Item[Int32]	Mendapatkan atau mengatur item pada indeks yang ditentukan dalam koleksi.
Item[String]	Mengambil item dengan kunci yang ditentukan.

Metode

Add(ListViewItem)	Menambahkan yang sudah ada ListViewItem ke koleksi.
Add(String)	Membuat item dengan teks yang ditentukan dan menambahkannya ke koleksi.
Add(String, Int32)	Membuat item dengan teks dan gambar yang ditentukan dan menambahkannya ke koleksi.
Add(String, String)	Membuat item dengan teks dan gambar yang ditentukan dan menambahkannya ke koleksi.
Add(String, String, Int32)	Membuat item dengan kunci, teks, dan gambar yang ditentukan dan menambahkan item ke koleksi.
Add(String, String, String)	Membuat item dengan kunci, teks, dan gambar yang ditentukan, dan menambahkannya ke koleksi.
AddRange(ListView+ListViewItemCollection)	Menambahkan kumpulan item ke koleksi.
AddRange(ListViewItem[])	Menambahkan array ListViewItem objek ke koleksi.
Clear()	Menghapus semua item dari koleksi.
Contains(ListViewItem)	Menentukan apakah item yang ditentukan terletak di koleksi.
ContainsKey(String)	Menentukan apakah koleksi berisi item dengan kunci yang ditentukan.
CopyTo(Array, Int32)	Menyalin seluruh koleksi ke dalam array yang ada di lokasi tertentu dalam array.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Find(String, Boolean)	Mencari item yang namanya cocok dengan kunci yang ditentukan, secara opsional mencari subitem.
GetEnumerator()	Mengembalikan enumerator yang akan digunakan untuk melakukan iterasi melalui kumpulan item.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IndexOf(ListViewItem)	Mengembalikan indeks dalam kumpulan item yang ditentukan.
IndexOfKey(String)	Mengambil indeks item dengan kunci yang ditentukan.
Insert(Int32, ListViewItem)	Menyisipkan yang sudah ada ListViewItem ke dalam koleksi pada indeks yang ditentukan.
Insert(Int32, String)	Membuat item baru dan menyisipkannya ke dalam koleksi pada indeks yang ditentukan.
Insert(Int32, String, Int32)	Membuat item baru dengan indeks gambar yang ditentukan dan menyisipkannya ke dalam koleksi pada indeks yang ditentukan.
Insert(Int32, String, String)	Membuat item baru dengan teks dan gambar yang ditentukan dan menyisipkannya dalam koleksi pada indeks yang ditentukan.
Insert(Int32, String, String, Int32)	Membuat item baru dengan kunci, teks, dan gambar yang ditentukan, dan menyisipkannya dalam koleksi pada indeks yang ditentukan.
Insert(Int32, String, String, String)	Membuat item baru dengan kunci, teks, dan gambar yang ditentukan, dan menambahkannya ke koleksi pada indeks yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
Remove(ListViewItem)	Menghapus item yang ditentukan dari koleksi.
RemoveAt(Int32)	Menghapus item pada indeks yang ditentukan dalam koleksi.
RemoveByKey(String)	Menghapus item dengan kunci yang ditentukan dari koleksi.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

ICollection.IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke koleksi disinkronkan (utas aman).
ICollection.SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke kumpulan kontrol.
IList.Add(Object)	Menambahkan objek yang ada ke koleksi.
IList.Contains(Object)	Menentukan apakah item yang ditentukan ada dalam koleksi.
IList.IndexOf(Object)	Mengembalikan indeks dalam kumpulan item yang ditentukan.
IList.Insert(Int32, Object)	Menyisipkan objek ke dalam koleksi pada indeks yang ditentukan.
IList.IsFixedSize	Mendapatkan nilai yang menunjukkan apakah koleksi memiliki ukuran tetap.
IList.Item[Int32]	Mendapatkan atau mengatur pada ListViewItem indeks yang ditentukan dalam koleksi.
IList.Remove(Object)	Menghapus item yang ditentukan dari koleksi.

Metode Ekstensi

Lihat juga

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection