Teilen über


CheckedListBox.SetItemCheckState(Int32, CheckState) Methode

Definition

Legt den Aktivierungszustand des Elements am angegebenen Index fest.

public:
 void SetItemCheckState(int index, System::Windows::Forms::CheckState value);
public void SetItemCheckState (int index, System.Windows.Forms.CheckState value);
member this.SetItemCheckState : int * System.Windows.Forms.CheckState -> unit
Public Sub SetItemCheckState (index As Integer, value As CheckState)

Parameter

index
Int32

Der Index des Elements, dessen Zustand festgelegt werden soll.

value
CheckState

Einer der CheckState-Werte.

Ausnahmen

Der angegebene index ist kleiner als 0.

- oder -

Der index ist größer oder gleich der Anzahl der Elemente in der Liste.

Der value ist keiner der CheckState-Werte.

Beispiele

Im folgenden Beispiel werden die Elemente im CheckedListBox aufgelistet und jedes andere Element in der Liste überprüft. Das Beispiel veranschaulicht die Verwendung der SetItemCheckState Methoden und SetItemChecked zum Festlegen des Überprüfungszustands eines Elements. Für jedes andere Element, das überprüft werden soll, wird aufgerufen, SetItemCheckState um auf CheckStateIndeterminatefestzulegen, während SetItemChecked für das andere Element aufgerufen wird, um den überprüften Zustand auf Checkedfestzulegen.

Das Beispiel veranschaulicht auch die Verwendung der Items -Eigenschaft, um die CheckedListBox.ObjectCollection von Elementen abzurufen Count .

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

Hinweise

Die SetItemCheckState-Methode löst das ItemCheck-Ereignis aus.

Elemente, deren CheckState Einstellung mit einem Häkchen im Kontrollkästchen angezeigt Indeterminate wird, das Kontrollkästchen ist jedoch abgeblendet, um die unbestimmte status des aktivierten Elements anzugeben.

Gilt für:

Weitere Informationen