CheckedListBox.Items Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 dieser CheckedListBox ab.

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.ObjectCollection

Public ReadOnly Property Items As CheckedListBox.ObjectCollection

Eigenschaftswert

CheckedListBox.ObjectCollection

Die CheckedListBox.ObjectCollection-Auflistung, die die Elemente in CheckedListBox darstellt.

Beispiele

Im folgenden Beispiel werden die aktivierten Elemente in CheckedListBox.CheckedIndexCollection aufgelistet, um zu sehen, in welchem Prüfzustand 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.CheckedIndexCollection- und der CheckedItems -Eigenschaft zum Abrufen von CheckedListBox.CheckedItemCollection.

Die erste Schleife verwendet die GetItemCheckState -Methode, um die CheckState von jedem überprüften Element zu erhalten, wenn der Index des Elements angegeben ist. In der zweiten Schleife wird ebenfalls verwendet GetItemCheckState, aber die ListBox.ObjectCollection.IndexOf -Methode verwendet, 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 Items der -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 Elementauflistung ausgeführt werden können, finden Sie in den Referenzthemen der CheckedListBox.ObjectCollection Klasse.

Gilt für:

Freigeben über