CheckedListBox.SetItemChecked-Methode

Legt CheckState für das Element am angegebenen Index auf Checked fest.

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

Syntax

'Declaration
Public Sub SetItemChecked ( _
    index As Integer, _
    value As Boolean _
)
'Usage
Dim instance As CheckedListBox
Dim index As Integer
Dim value As Boolean

instance.SetItemChecked(index, value)

public void SetItemChecked (
    int index,
    bool value
)

public:
void SetItemChecked (
    int index, 
    bool value
)

public void SetItemChecked (
    int index, 
    boolean value
)

public function SetItemChecked (
    index : int, 
    value : boolean
)

Parameter

• index
  Der Index des Elements, dessen Aktivierungszustand festgelegt werden soll.

• value
  true, um das Element als aktiviert festzulegen, andernfalls false.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der angegebene Index ist kleiner als 0. - oder - Der Index ist größer als die Anzahl der Elemente in der Liste.

Hinweise

Wenn der Wert true übergeben wird, legt diese Methode den CheckState-Wert auf Checked fest. Durch den Wert false wird CheckState auf Unchecked festgelegt.

Beispiel

Im folgenden Beispiel werden die Elemente in der CheckedListBox aufgelistet, und jedes zweite Element in der Liste wird aktiviert. Im Beispiel wird die Verwendung der SetItemCheckState-Methode und der SetItemChecked-Methode zum Festlegen des Aktivierungszustands eines Elements veranschaulicht. 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.

Im Beispiel wird auch die Verwendung der Items-Eigenschaft zum Abrufen der CheckedListBox.ObjectCollection veranschaulicht, um Count für die Elemente abzurufen.

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

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-Klasse
CheckedListBox-Member
System.Windows.Forms-Namespace