CheckedListBox.CheckedIndexCollection Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

CheckedListBox.CheckedIndexCollection.cs

Merangkum kumpulan indeks item yang dicentang (termasuk item dalam status tidak ditentukan) dalam CheckedListBox.

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

public class CheckedListBox.CheckedIndexCollection : System.Collections.IList

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

Public Class CheckedListBox.CheckedIndexCollection
Implements IList

Warisan

Object

CheckedListBox.CheckedIndexCollection

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 indeks yang dicentang adalah subset indeks ke dalam kumpulan semua item dalam CheckedListBox kontrol. Indeks ini menentukan item 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 menunjukkan kumpulan indeks terindeks dari item yang dicentang.

Indeks	Indeks Item
0	1
1	3
2	4

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 nilai 3. Panggilan ke IndexOf dengan parameter 3 mengembalikan nilai 1.

Properti

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

Metode

Nama	Deskripsi
Contains(Int32)	Menentukan apakah indeks 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 CheckedIndices koleksi.
IndexOf(Int32)	Mengembalikan indeks ke dalam kumpulan indeks yang dicentang.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ICollection.IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke CheckedListBox.CheckedIndexCollection disinkronkan (utas aman).
ICollection.SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke kumpulan kontrol. Untuk deskripsi anggota ini, lihat SyncRoot.
IList.Add(Object)	API ini mendukung infrastruktur produk dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. Menambahkan item ke CheckedListBox.CheckedIndexCollection. Untuk deskripsi anggota ini, lihat Add(Object).
IList.Clear()	Menghapus semua item dari CheckedListBox.CheckedIndexCollection. Untuk deskripsi anggota ini, lihat Clear().
IList.Contains(Object)	Menentukan apakah indeks yang ditentukan terletak di CheckedListBox.CheckedIndexCollectiondalam . Untuk deskripsi anggota ini, lihat Contains(Object).
IList.IndexOf(Object)	Untuk deskripsi anggota ini, lihat IndexOf(Object).
IList.Insert(Int32, Object)	Untuk deskripsi anggota ini, lihat Insert(Int32, Object).
IList.IsFixedSize	Untuk deskripsi anggota ini, lihat IsFixedSize.
IList.Item[Int32]	Untuk deskripsi anggota ini, lihat Item[Int32].
IList.Remove(Object)	Untuk deskripsi anggota ini, lihat Remove(Object).
IList.RemoveAt(Int32)	atau deskripsi anggota ini, lihat RemoveAt(Int32).

Lihat juga

• CheckedIndices
• CheckedItems
• Items