CheckedListBox.CheckedIndexCollection Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Hermetyzuje kolekcję indeksów zaznaczonych elementów (w tym elementów w stanie nieokreślonym) w obiekcie 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

Dziedziczenie

Object

CheckedListBox.CheckedIndexCollection

Implementuje

ICollection IEnumerable IList

Przykłady

Poniższy przykład wylicza elementy zaewidencjonowane w elemencie CheckedListBox.CheckedIndexCollection , aby zobaczyć, w jakim stanie jest element sprawdzania. W przykładzie GetItemCheckState pokazano użycie metody w celu ustawienia stanu sprawdzania elementu. W przykładzie pokazano również użycie CheckedIndices właściwości w celu pobrania CheckedListBox.CheckedIndexCollectionwłaściwości , a CheckedItems właściwość w celu pobrania CheckedListBox.CheckedItemCollectionelementu .

Pierwsza pętla używa GetItemCheckState metody do pobrania CheckState każdego zaznaczonego elementu, biorąc pod uwagę indeks elementu. Druga pętla używa również metody GetItemCheckState, ale używa ListBox.ObjectCollection.IndexOf metody do pobrania indeksu dla elementu.

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

Uwagi

Kolekcja indeksów sprawdzanych jest podzbiorem indeksów do kolekcji wszystkich elementów w kontrolce CheckedListBox . Te indeksy określają elementy w stanie zaewidencjonowanym lub nieokreślonym.

Poniższa tabela jest przykładem indeksowanej kolekcji elementów w kontrolce (wszystkie elementy zawarte w kontrolce).

Indeks	Element	Sprawdź stan
0	obiekt 1	Unchecked
1	obiekt 2	Checked
2	obiekt 3	Unchecked
3	obiekt 4	Indeterminate
4	obiekt 5	Checked

Na podstawie poprzedniego przykładu poniższa tabela przedstawia indeksowaną kolekcję indeksów zaznaczonych elementów.

Indeks	Indeks elementu
0	1
1	3
2	4

Klasa CheckedListBox ma dwa elementy członkowskie, które umożliwiają dostęp do przechowywanych indeksów, Item[] właściwości i IndexOf metody.

Na podstawie poprzedniego przykładu wywołanie Item[] właściwości z wartością parametru 1 zwraca wartość 3. Wywołanie metody IndexOf z parametrem 3 zwraca wartość 1.

Właściwości

Count	Pobiera liczbę zaznaczonych elementów.
IsReadOnly	Pobiera wartość wskazującą, czy kolekcja jest przeznaczona tylko do odczytu.
Item[Int32]	Pobiera indeks zaznaczonego elementu w kontrolce CheckedListBox .

Metody

Contains(Int32)	Określa, czy określony indeks znajduje się w kolekcji.
CopyTo(Array, Int32)	Kopiuje całą kolekcję do istniejącej tablicy w określonej lokalizacji w tablicy.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetEnumerator()	Zwraca moduł wyliczający, którego można użyć do iterowania w kolekcji CheckedIndices .
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IndexOf(Int32)	Zwraca indeks do kolekcji zaznaczonych indeksów.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.IsSynchronized	Pobiera wartość wskazującą, czy dostęp do elementu CheckedListBox.CheckedIndexCollection jest synchronizowany (bezpieczny wątek).
ICollection.SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji kontrolek. Aby uzyskać opis tego elementu członkowskiego, zobacz SyncRoot.
IList.Add(Object)	Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu. Dodaje element do elementu CheckedListBox.CheckedIndexCollection. Aby uzyskać opis tego elementu członkowskiego, zobacz Add(Object).
IList.Clear()	Usuwa wszystkie elementy z elementu CheckedListBox.CheckedIndexCollection. Aby uzyskać opis tego elementu członkowskiego, zobacz Clear().
IList.Contains(Object)	Określa, czy określony indeks znajduje się w obiekcie CheckedListBox.CheckedIndexCollection. Aby uzyskać opis tego elementu członkowskiego, zobacz Contains(Object).
IList.IndexOf(Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz IndexOf(Object).
IList.Insert(Int32, Object)	Aby uzyskać opis tego członka, zobacz Insert(Int32, Object).
IList.IsFixedSize	Aby uzyskać opis tego członka, zobacz IsFixedSize.
IList.Item[Int32]	Aby uzyskać opis tego członka, zobacz Item[Int32].
IList.Remove(Object)	Aby uzyskać opis tego członka, zobacz Remove(Object).
IList.RemoveAt(Int32)	lub opis tego członka, zobacz RemoveAt(Int32).

Metody rozszerzania

Cast<TResult>(IEnumerable)	Rzutuje elementy elementu IEnumerable na określony typ.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable elementu na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje element IEnumerable na .IQueryable

Zobacz też

• CheckedIndices
• CheckedItems
• Items