CheckedListBox.ObjectCollection-Klasse

Stellt die Auflistung von Elementen in einer CheckedListBox dar.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Class ObjectCollection
    Inherits ObjectCollection
'Usage
Dim instance As ObjectCollection

public class ObjectCollection : ObjectCollection

public ref class ObjectCollection : public ObjectCollection

public class ObjectCollection extends ObjectCollection

public class ObjectCollection extends ObjectCollection

Hinweise

Auf die Auflistung kann mithilfe der Items-Eigenschaft aus dem übergeordneten Steuerelement, CheckedListBox, zugegriffen werden. Zum Erstellen einer Auflistung von Objekten für die Anzeige im CheckedListBox-Steuerelement können Sie die Elemente einzeln mithilfe der Add-Methode und der Remove-Methode hinzufügen bzw. entfernen.

Beispiel

Im folgenden Beispiel werden die Elemente in der CheckedListBox aufgelistet, und jedes zweite Element in der Liste wird aktiviert. Das Beispiel veranschaulicht die Verwendung der Items-Eigenschaft zum Abrufen der CheckedListBox.ObjectCollection, um Count für die Elemente abzurufen.

Das Beispiel veranschaulicht auch die Verwendung der SetItemCheckState-Methode und der SetItemChecked-Methode zum Festlegen des Aktivierungszustands eines Elements. Für jedes zweite Element, das aktiviert werden soll, wird SetItemCheckState aufgerufen, um CheckState auf Indeterminate festzulegen, während für das jeweils andere Element SetItemChecked aufgerufen wird, um Checked als Aktivierungszustand festzulegen.

Private Sub CheckEveryOther_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CheckEveryOther.Click
    ' Cycle through every item and check every other.
    Dim i As Integer

    ' Set flag to true to know when this code is being executed. Used in the ItemCheck
    ' event handler.
    insideCheckEveryOther = True

    For i = 0 To CheckedListBox1.Items.Count - 1
        ' For every other item in the list, set as checked.

        If ((i Mod 2) = 0) Then
            ' But for each other item that is to be checked, set as being in an
            ' indeterminate checked state.

            If ((i Mod 4) = 0) Then
                CheckedListBox1.SetItemCheckState(i, CheckState.Indeterminate)
            Else
                CheckedListBox1.SetItemChecked(i, True)
            End If
        End If
    Next

    insideCheckEveryOther = False

End Sub

private void CheckEveryOther_Click(object sender, System.EventArgs e) {
    // Cycle through every item and check every other.

    // Set flag to true to know when this code is being executed. Used in the ItemCheck
    // event handler.
    insideCheckEveryOther = true;

    for (int i = 0; i < checkedListBox1.Items.Count; i++) {
        // For every other item in the list, set as checked.
        if ((i % 2) == 0) {
            // But for each other item that is to be checked, set as being in an
            // indeterminate checked state.
            if ((i % 4) == 0)
                checkedListBox1.SetItemCheckState(i, CheckState.Indeterminate);
            else
                checkedListBox1.SetItemChecked(i, true);
        }
    }        

    insideCheckEveryOther = false;
}

void CheckEveryOther_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Cycle through every item and check every other.
   // Set flag to true to know when this code is being executed. Used in the ItemCheck
   // event handler.
   insideCheckEveryOther = true;
   for ( int i = 0; i < checkedListBox1->Items->Count; i++ )
   {
      
      // For every other item in the list, set as checked.
      if ( (i % 2) == 0 )
      {
         
         // But for each other item that is to be checked, set as being in an
         // indeterminate checked state.
         if ( (i % 4) == 0 )
                     checkedListBox1->SetItemCheckState( i, CheckState::Indeterminate );
         else
                     checkedListBox1->SetItemChecked( i, true );
      }

   }
   insideCheckEveryOther = false;
}

private void checkEveryOther_Click(Object sender, System.EventArgs e)
{
    // Cycle through every item and check every other.
    // Set flag to true to know when this code is being executed. 
    // Used in the ItemCheck event handler.
    insidecheckEveryOther = true;
    for (int i = 0; i < checkedListBox1.get_Items().get_Count(); i++) {
        // For every other item in the list, set as checked.
        if (i % 2 == 0) {
            // But for each other item that is to be checked, set as being 
            // in an indeterminate checked state.
            if (i % 4 == 0) {
                checkedListBox1.SetItemCheckState(i, 
                    CheckState.Indeterminate);
            }
            else {
                checkedListBox1.SetItemChecked(i, true);
            }
        }
    }
    insidecheckEveryOther = false;
} //checkEveryOther_Click

Vererbungshierarchie

System.Object
   System.Windows.Forms.ListBox.ObjectCollection
    System.Windows.Forms.CheckedListBox.ObjectCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

CheckedListBox.ObjectCollection-Member
System.Windows.Forms-Namespace