CheckedListBox.CheckedItemCollection-Klasse
Aktualisiert: November 2007
Kapselt die Auflistung markierter Elemente (einschließlich der Elemente in unbestimmtem Zustand) in einem CheckedListBox-Steuerelement.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Die Auflistung markierter Elemente ist eine Teilmenge sämtlicher Elemente im CheckedListBox-Steuerelement. Sie enthält nur die Elemente in aktiviertem oder unbestimmtem Zustand.
Die folgende Tabelle enthält ein Beispiel für die indizierte Auflistung von Elementen im Steuerelement, d. h. sämtliche im Steuerelement enthaltenen Elemente.
Index | Element | Aktivierungszustand |
|---|---|---|
0 | Objekt 1 | |
1 | Objekt 2 | |
2 | Objekt 3 | |
3 | Objekt 4 | |
4 | Objekt 5 |
Auf Grundlage des oben stehenden Beispiels veranschaulicht die folgende Tabelle die indizierte Auflistung der markierten Elemente.
Index | Element |
|---|---|
0 | Objekt 2 |
1 | Objekt 4 |
2 | Objekt 5 |
Die CheckedListBox-Klasse enthält zwei Member, mit denen Sie auf die gespeicherten Indizes zugreifen können, nämlich die Item-Eigenschaft und die IndexOf-Methode.
Auf Grundlage des oben stehenden Beispiels wird bei einem Aufruf der Item-Eigenschaft mit dem Parameterwert 1 das Objekt 4 zurückgegeben. Bei einem Aufruf von IndexOf mit dem Parameter Objekt 4 wird der Wert 1 zurückgegeben.
Das folgende Beispiel listet die aktivierten Elemente in der CheckedListBox.CheckedIndexCollection auf, um den Aktivierungszustand der einzelnen Elemente anzuzeigen. Das Beispiel veranschaulicht die Verwendung der GetItemCheckState-Methode zum Festlegen des Aktivierungszustands eines Elements. Das Beispiel veranschaulicht auch die Verwendung der CheckedIndices-Eigenschaft zum Abrufen der CheckedListBox.CheckedIndexCollection und der CheckedItems-Eigenschaft zum Abrufen der CheckedListBox.CheckedItemCollection.
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.
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 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 objEnum = checkedListBox1.get_CheckedIndices().
GetEnumerator();
while (objEnum.MoveNext()) {
int indexChecked = (int)(Int32)(objEnum.get_Current());
// The indexChecked variable contains the index of the item.
MessageBox.Show("Index#: " + (Int32)indexChecked
+ ", is checked. Checked state is:"
+ checkedListBox1.GetItemCheckState(indexChecked).ToString()
+ ".");
}
// Next show the object title and check state for each item selected.
for (int iCtr = 0;
iCtr < checkedListBox1.get_CheckedItems().get_Count();
iCtr++) {
Object itemChecked =
checkedListBox1.get_CheckedItems().get_Item(iCtr);
// 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.get_Items().IndexOf(itemChecked)).ToString()
+ ".");
}
} //whatIsChecked_Click
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.