CheckedListBox.Items 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.
Ruft die Auflistung von Elementen in diesem CheckedListBoxab.
public:
property System::Windows::Forms::CheckedListBox::ObjectCollection ^ Items { System::Windows::Forms::CheckedListBox::ObjectCollection ^ get(); };public System.Windows.Forms.CheckedListBox.ObjectCollection Items { get; }member this.Items : System.Windows.Forms.CheckedListBox.ObjectCollectionPublic ReadOnly Property Items As CheckedListBox.ObjectCollectionEigenschaftswert
Die CheckedListBox.ObjectCollection Auflistung, die die Elemente in der CheckedListBox.
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 Items Eigenschaft verwendet, um den CheckedListBox.ObjectCollection Index eines Elements mithilfe der ListBox.ObjectCollection.IndexOf Methode abzurufen. Das Beispiel veranschaulicht auch die Verwendung der CheckedIndices Eigenschaft zum Abrufen der CheckedListBox.CheckedIndexCollectionEigenschaft und der CheckedItems Eigenschaft zum Abrufen der CheckedListBox.CheckedItemCollection.
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.
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
Mit der Items Eigenschaft können Sie einen Verweis auf die Liste der Elemente abrufen, die derzeit in einem CheckedListBox Steuerelement gespeichert sind. Mit diesem Verweis können Sie Elemente hinzufügen, Elemente entfernen und eine Anzahl der Elemente in der Auflistung abrufen. Weitere Informationen zu den Aufgaben, die mit der Elementsammlung ausgeführt werden können, finden Sie in den Themen zur CheckedListBox.ObjectCollection Klassenreferenz.
