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.
Sammlung der eingecheckten Elemente in diesem 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 die CheckedListBox.
- Attribute
Beispiele
Im folgenden Beispiel werden die eingecheckten Elemente aufgelistet CheckedListBox.CheckedIndexCollection , um zu sehen, in welchem Überprüfungsstatus sich ein Element befindet. Im Beispiel wird die Verwendung der CheckedIndices Eigenschaft zum Abrufen der CheckedListBox.CheckedIndexCollectionEigenschaft und der CheckedItems Eigenschaft zum Abrufen der CheckedListBox.CheckedItemCollectionEigenschaft veranschaulicht.
Die erste Schleife verwendet die GetItemCheckState Methode, um die CheckState einzelnen überprüften Elemente abzurufen, je nach Index des Elements. Die zweite Schleife verwendet GetItemCheckStateauch die Methode, ListBox.ObjectCollection.IndexOf 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 ein CheckedListBox und ein Button hinzu.
Benennen Sie die Schaltfläche
WhatIsChecked, fügen Sie einen Handler für das Click Ereignis hinzu, und kopieren Sie den Code aus dem Textkörper des folgenden Handlers.Fügen Sie der Datei 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 Items Auflistung, die nur die Elemente darstellen, deren System.Windows.Forms.CheckState Oder CheckedIndeterminate. Die Indizes in dieser Auflistung befinden sich in aufsteigender Reihenfolge.
