CheckedListBox.CheckedItemCollection Klasse

Definition

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
CheckedListBox.CheckedItemCollection
Implementiert

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

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.

Gilt für: