CheckedListBox.CheckedItemCollection Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

CheckedListBox.CheckedItemCollection.cs

Merangkum kumpulan item yang dicentang, termasuk item dalam status tidak ditentukan, dalam CheckedListBox kontrol.

public: ref class CheckedListBox::CheckedItemCollection : System::Collections::IList

public class CheckedListBox.CheckedItemCollection : System.Collections.IList

type CheckedListBox.CheckedItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class CheckedListBox.CheckedItemCollection
Implements IList

Warisan

Object

CheckedListBox.CheckedItemCollection

Penerapan

ICollection IEnumerable IList

Contoh

Contoh berikut menghitung item yang dicentang di CheckedListBox.CheckedIndexCollection untuk melihat status pemeriksaan item. Contoh menunjukkan menggunakan GetItemCheckState metode untuk mengatur status pemeriksaan item. Contohnya juga menunjukkan penggunaan CheckedIndices properti untuk mendapatkan CheckedListBox.CheckedIndexCollection, dan CheckedItems properti untuk mendapatkan CheckedListBox.CheckedItemCollection.

Perulangan pertama menggunakan GetItemCheckState metode untuk mendapatkan CheckState dari setiap item yang dicentang, mengingat indeks item. Perulangan kedua juga menggunakan GetItemCheckState, tetapi menggunakan ListBox.ObjectCollection.IndexOf metode untuk mengambil indeks untuk item.

void WhatIsChecked_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Display in a message box all the items that are checked.
   // First show the index and check state of all selected items.
   IEnumerator^ myEnum1 = checkedListBox1->CheckedIndices->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      Int32 indexChecked =  *safe_cast<Int32^>(myEnum1->Current);
      
      // The indexChecked variable contains the index of the item.
      MessageBox::Show( String::Concat( "Index#: ", indexChecked, ", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( indexChecked ), "." ) );
   }

   
   // Next show the Object* title and check state for each item selected.
   IEnumerator^ myEnum2 = checkedListBox1->CheckedItems->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      Object^ itemChecked = safe_cast<Object^>(myEnum2->Current);
      
      // Use the IndexOf method to get the index of an item.
      MessageBox::Show( String::Concat( "Item with title: \"", itemChecked, "\", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( checkedListBox1->Items->IndexOf( itemChecked ) ), "." ) );
   }
}

private void WhatIsChecked_Click(object sender, System.EventArgs e) {
    // Display in a message box all the items that are checked.

    // First show the index and check state of all selected items.
    foreach(int indexChecked in checkedListBox1.CheckedIndices) {
        // The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" +
                        checkedListBox1.GetItemCheckState(indexChecked).ToString() + ".");
    }

    // Next show the object title and check state for each item selected.
    foreach(object itemChecked in checkedListBox1.CheckedItems) {

        // Use the IndexOf method to get the index of an item.
        MessageBox.Show("Item with title: \"" + itemChecked.ToString() +
                        "\", is checked. Checked state is: " +
                        checkedListBox1.GetItemCheckState(checkedListBox1.Items.IndexOf(itemChecked)).ToString() + ".");
    }
}

Private Sub WhatIsChecked_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles WhatIsChecked.Click
    ' Display in a message box all the items that are checked.
    Dim indexChecked As Integer
    Dim itemChecked As Object
    Const quote As String = """"

    ' First show the index and check state of all selected items.
    For Each indexChecked In CheckedListBox1.CheckedIndices
        ' The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" + _
                        CheckedListBox1.GetItemCheckState(indexChecked).ToString() + ".")
    Next

    ' Next show the object title and check state for each item selected.
    For Each itemChecked In CheckedListBox1.CheckedItems

        ' Use the IndexOf method to get the index of an item.
        MessageBox.Show("Item with title: " + quote + itemChecked.ToString() + quote + _
                        ", is checked. Checked state is: " + _
                        CheckedListBox1.GetItemCheckState(CheckedListBox1.Items.IndexOf(itemChecked)).ToString() + ".")
    Next

End Sub

Keterangan

Kumpulan item yang dicentang adalah subset dari semua item dalam CheckedListBox kontrol; hanya berisi item yang dalam status dicentang atau tidak ditentukan.

Tabel berikut adalah contoh kumpulan item terindeks dalam kontrol (semua item yang terkandung dalam kontrol).

Indeks	Item	Periksa Status
0	objek 1	Unchecked
1	objek 2	Checked
2	objek 3	Unchecked
3	objek 4	Indeterminate
4	objek 5	Checked

Berdasarkan contoh sebelumnya, tabel berikut ini memperlihatkan kumpulan terindeks dari item yang dicentang.

Indeks	Item
0	objek 2
1	objek 4
2	objek 5

Kelas CheckedListBox ini memiliki dua anggota yang memungkinkan Anda mengakses indeks tersimpan Item[] , properti, dan IndexOf metode .

Berdasarkan contoh sebelumnya, panggilan ke Item[] properti dengan nilai parameter 1 mengembalikan objek 4. Panggilan ke IndexOf dengan parameter objek 4 mengembalikan nilai 1.

Properti

Nama	Deskripsi
Count	Mendapatkan jumlah item dalam koleksi.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah koleksi bersifat baca-saja.
Item[Int32]	Mendapatkan objek dalam kumpulan item yang dicentang.

Metode

Nama	Deskripsi
Contains(Object)	Menentukan apakah item yang ditentukan terletak di koleksi.
CopyTo(Array, Int32)	Menyalin seluruh koleksi ke dalam array yang ada di lokasi tertentu dalam array.
GetEnumerator()	Mengembalikan enumerator yang dapat digunakan untuk melakukan iterasi melalui CheckedItems koleksi.
IndexOf(Object)	Mengembalikan indeks ke dalam kumpulan item yang dicentang.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ICollection.IsSynchronized	Untuk deskripsi anggota ini, lihat IsSynchronized.
ICollection.SyncRoot	Untuk deskripsi anggota ini, lihat SyncRoot.
IList.Add(Object)	Untuk deskripsi anggota ini, lihat Add(Object).
IList.Clear()	Untuk deskripsi anggota ini, lihat Clear().
IList.Insert(Int32, Object)	Untuk deskripsi anggota ini, lihat Insert(Int32, Object).
IList.IsFixedSize	Untuk deskripsi anggota ini, lihat IsFixedSize.
IList.Remove(Object)	Untuk deskripsi anggota ini, lihat Remove(Object).
IList.RemoveAt(Int32)	Untuk deskripsi anggota ini, lihat RemoveAt(Int32).