CheckedListBox.CheckedItemCollection Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Hermetyzuje kolekcję zaznaczonych elementów, w tym elementy w stanie nieokreślonym, w kontrolce CheckedListBox .

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

Dziedziczenie: Object
CheckedListBox.CheckedItemCollection

Implementuje: ICollection IEnumerable IList

Przykłady

Poniższy przykład wylicza zaewidencjonowane elementy w elemencie CheckedListBox.CheckedIndexCollection , aby zobaczyć stan sprawdzania, w jakim stanie znajduje się element. 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 i CheckedItems właściwości w celu pobrania obiektu CheckedListBox.CheckedItemCollection.

Pierwsza pętla używa GetItemCheckState metody w celu pobrania CheckState każdego zaznaczonego elementu, biorąc pod uwagę indeks elementu. Druga pętla używa GetItemCheckStaterównież metody , ale używa ListBox.ObjectCollection.IndexOf metody w celu 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 elementów zaznaczonych jest podzbiorem wszystkich elementów w kontrolce CheckedListBox ; zawiera tylko te elementy, które są w stanie zaewidencjonowany lub nieokreślony.

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ę zaznaczonych elementów.

Indeks	Element
0	obiekt 2
1	obiekt 4
2	obiekt 5

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

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

Właściwości

Count	Pobiera liczbę elementów w kolekcji.
IsReadOnly	Pobiera wartość wskazującą, czy kolekcja jest tylko do odczytu.
Item[Int32]	Pobiera obiekt w kolekcji zaznaczonych elementów.

Metody

Contains(Object)	Określa, czy określony element 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óry może służyć do iterowania po kolekcji CheckedItems .
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(Object)	Zwraca indeks do kolekcji zaznaczonych elementó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	Aby uzyskać opis tego członka, zobacz IsSynchronized.
ICollection.SyncRoot	Aby uzyskać opis tego członka, zobacz SyncRoot.
IList.Add(Object)	Aby uzyskać opis tego członka, zobacz Add(Object).
IList.Clear()	Aby uzyskać opis tego członka, zobacz Clear().
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.Remove(Object)	Aby uzyskać opis tego członka, zobacz Remove(Object).
IList.RemoveAt(Int32)	Aby uzyskać 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

Dotyczy