CheckedListBox.CheckedItems-Eigenschaft

Die Auflistung ist eine Teilmenge der Objekte in der Items-Auflistung, die nur die Elemente darstellt, deren System.Windows.Forms.CheckStateChecked oder Indeterminate ist. Die Indizes in dieser Auflistung werden in aufsteigender Reihenfolge sortiert.

Im folgenden Beispiel werden die überprüften Elemente im CheckedListBox.CheckedIndexCollection aufgelistet, um anzuzeigen, in welchem Aktivierungszustand ein Element darin ist. Im Beispiel wird auch die Verwendung der CheckedIndices-Eigenschaft zum Abrufen der Eigenschaften CheckedListBox.CheckedIndexCollection und CheckedItems veranschaulicht, um CheckedListBox.CheckedItemCollection abzurufen.

Die erste Schleife verwendet die GetItemCheckState-Methode zum Abrufen des CheckState der einzelnen Elemente unter Angabe des Index des Elements. Die zweite Schleife verwendet ebenfalls GetItemCheckState, allerdings wird die ListBox.ObjectCollection.IndexOf-Methode verwendet, um den Index des Elements abzurufen.

Um dieses Codebeispiel auszuführen, führen Sie die folgenden Schritte aus:

1. Erstellen Sie eine neue Windows Forms-Anwendung.

2. Fügen Sie dem Formular CheckedListBox und Button hinzu.

3. Nennen Sie die Schaltfläche WhatIsChecked, fügen Sie einen Handler für das Click-Ereignis hinzu, und kopieren Sie den Text aus folgendem Handler in den Code.

4. Fügen Sie der CheckedListBox einige Elemente hinzu.

5. Führen Sie das Beispiel aus, und überprüfen Sie einige der Kontrollkästchen im Listenfeld.

6. Klicken Sie auf die Schaltfläche.

   Es wird eine Reihe von Meldungsfeldern angezeigt, in denen angegeben wird, welche Elemente überprüft wurden.

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() + ".");
    }

}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz