CheckedListBox.CheckedItems Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Auflistung aktivierter Elemente in dieser CheckedListBox.
public:
property System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ CheckedItems { System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ get(); };[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.CheckedListBox.CheckedItemCollection CheckedItems { get; }[<System.ComponentModel.Browsable(false)>]
member this.CheckedItems : System.Windows.Forms.CheckedListBox.CheckedItemCollectionPublic ReadOnly Property CheckedItems As CheckedListBox.CheckedItemCollectionEigenschaftswert
Die CheckedListBox.CheckedItemCollection-Auflistung für CheckedListBox.
- Attribute
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 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.
Führen Sie zum Ausführen dieses Beispiels die folgenden Schritte aus:
Erstellen Sie eine neue Windows Forms-Anwendung.
Fügen Sie dem Formular eine CheckedListBox und eine Button hinzu.
Benennen Sie die Schaltfläche
WhatIsChecked, fügen Sie einen Handler für ihr Click Ereignis hinzu, und kopieren Sie den Code aus dem Textkörper des folgenden Handlers.Fügen Sie dem einige Elemente hinzu CheckedListBox.
Führen Sie das Beispiel aus, und aktivieren Sie einige der Kontrollkästchen im Listenfeld.
Klicken Sie auf die Schaltfläche.
Es wird eine Reihe von Meldungsfeldern angezeigt, die angeben, welche Elemente aktiviert wurden.
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 ist eine Teilmenge der Objekte in der Auflistung, die Items nur die Elemente darstellt, deren System.Windows.Forms.CheckState oder IndeterminateistChecked. Die Indizes in dieser Auflistung befinden sich in aufsteigender Reihenfolge.
