CheckedListBox.CheckedItemCollection Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Kapselt die Auflistung der aktivierten Elemente in einem CheckedListBox-Steuerelement, einschließlich der Elemente in einem unbestimmten Zustand.

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

Vererbung

Object

CheckedListBox.CheckedItemCollection

Implementiert

ICollection IEnumerable IList

Beispiele

Im folgenden Beispiel werden die aktivierten Elemente im CheckedListBox.CheckedIndexCollection aufgezählt, um zu sehen, in welchem Überprüfungszustand sich ein Element befindet. Das Beispiel veranschaulicht die Verwendung der GetItemCheckState -Methode zum Festlegen des Überprüfungszustands eines Elements. Das Beispiel veranschaulicht auch die Verwendung der CheckedIndices -Eigenschaft zum Abrufen der CheckedListBox.CheckedIndexCollection- und der CheckedItems -Eigenschaft zum Abrufen von CheckedListBox.CheckedItemCollection.

Die erste Schleife verwendet die GetItemCheckState -Methode, um die der CheckState einzelnen überprüften Elemente abzurufen, wenn der Index des Elements angegeben ist. Die zweite Schleife verwendet GetItemCheckStateebenfalls , aber die ListBox.ObjectCollection.IndexOf -Methode, um den Index für das Element abzurufen.

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

Hinweise

Die Auflistung überprüfter Elemente ist eine Teilmenge aller Elemente im CheckedListBox Steuerelement. Sie enthält nur die Elemente, die sich in einem aktivierten oder unbestimmten Zustand befinden.

Die folgende Tabelle enthält ein Beispiel für die indizierte Auflistung von Elementen im Steuerelement (alle im Steuerelement enthaltenen Elemente).

Index	Artikel	Überprüfen des Zustands
0	Objekt 1	Unchecked
1	Objekt 2	Checked
2	Objekt 3	Unchecked
3	Objekt 4	Indeterminate
4	Objekt 5	Checked

Basierend auf dem vorherigen Beispiel zeigt die folgende Tabelle die indizierte Auflistung der überprüften Elemente.

Index	Element
0	Objekt 2
1	Objekt 4
2	Objekt 5

Die CheckedListBox -Klasse verfügt über zwei Member, mit denen Sie auf die gespeicherten Indizes zugreifen können, die Item[] -Eigenschaft und die IndexOf -Methode.

Basierend auf dem vorherigen Beispiel gibt ein Aufruf der -Eigenschaft mit dem Item[] Parameterwert 1 objekt 4 zurück. Ein Aufruf von IndexOf mit einem Parameter von Objekt 4 gibt den Wert 1 zurück.

Eigenschaften

Count	Ruft die Anzahl der Elemente in der Auflistung ab.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.
Item[Int32]	Ruft ein Objekt in der Auflistung markierter Elemente ab.

Methoden

Contains(Object)	Bestimmt, ob das angegebene Element in der Auflistung enthalten ist.
CopyTo(Array, Int32)	Kopiert die gesamte Auflistung an eine angegebene Position in einem vorhandenen Array.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt einen Enumerator zurück, mit dem die CheckedItems-Auflistung durchlaufen werden kann.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(Object)	Gibt einen Index in der Auflistung aktivierter Elemente zurück.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.IsSynchronized	Eine Beschreibung dieses Elements finden Sie unter IsSynchronized.
ICollection.SyncRoot	Eine Beschreibung dieses Elements finden Sie unter SyncRoot.
IList.Add(Object)	Eine Beschreibung dieses Elements finden Sie unter Add(Object).
IList.Clear()	Eine Beschreibung dieses Elements finden Sie unter Clear().
IList.Insert(Int32, Object)	Eine Beschreibung dieses Elements finden Sie unter Insert(Int32, Object).
IList.IsFixedSize	Eine Beschreibung dieses Elements finden Sie unter IsFixedSize.
IList.Remove(Object)	Eine Beschreibung dieses Elements finden Sie unter Remove(Object).
IList.RemoveAt(Int32)	Eine Beschreibung dieses Elements finden Sie unter RemoveAt(Int32).

Erweiterungsmethoden