Gewusst wie: Reagieren auf das Klicken auf Kontrollkästchen in Windows Forms

Aktualisiert: November 2007

Sobald ein Benutzer auf das CheckBox-Steuerelement in Windows Forms klickt, wird das Click-Ereignis ausgelöst. Sie können Ihre Anwendung so programmieren, dass abhängig vom Zustand des Kontrollkästchens eine bestimmte Aktion ausgeführt wird.

So reagieren Sie auf das Klicken auf Kontrollkästchen

• Stellen Sie im Click-Ereignishandler anhand der Checked-Eigenschaft den Zustand des Steuerelements fest, und führen Sie alle erforderlichen Aktionen aus.

  Private Sub CheckBox1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.Click
     ' The CheckBox control's Text property is changed each time the 
     ' control is clicked, indicating a checked or unchecked state.
     If CheckBox1.Checked = True Then
        CheckBox1.Text = "Checked"
     Else
        CheckBox1.Text = "Unchecked"
     End If
  End Sub
  

  private void checkBox1_Click(object sender, System.EventArgs e)
  {
     // The CheckBox control's Text property is changed each time the 
     // control is clicked, indicating a checked or unchecked state.
     if (checkBox1.Checked)
     {
        checkBox1.Text = "Checked";
     }
     else
     {
        checkBox1.Text = "Unchecked";
     }
  }
  

  private:
     void checkBox1_CheckedChanged(System::Object ^ sender,
        System::EventArgs ^ e)
     {
        if (checkBox1->Checked)
        {
           checkBox1->Text = "Checked";
        }
        else
        {
           checkBox1->Text = "Unchecked";
        }
     }
  

  Hinweis:
  Wenn der Benutzer auf das CheckBox-Steuerelement doppelklickt, wird jedes Klicken einzeln verarbeitet, das Doppelklickereignis wird also vom CheckBox-Steuerelement nicht unterstützt.

  Hinweis:
  Wenn der Wert der AutoCheck-Eigenschaft true lautet (der Standardwert), wird das CheckBox-Steuerelement durch Klicken automatisch aktiviert bzw. deaktiviert. Andernfalls muss der Wert der Checked-Eigenschaft bei Auftreten des Click-Ereignisses manuell festgelegt werden.

  Darüber hinaus können Sie mit dem CheckBox-Steuerelement eine Aktion ausführen.

So legen Sie fest, welche Aktion beim Klicken auf ein Kontrollkästchen ausgeführt wird

• Fragen Sie den Wert der CheckState-Eigenschaft mit einer Case-Anweisung ab, um die Aktion zu bestimmen. Wenn die ThreeState-Eigenschaft auf true festgelegt ist, kann die CheckState-Eigenschaft einen der folgenden drei Zustandswerte zurückgeben: Das Kästchen ist aktiviert, das Kästchen ist deaktiviert, oder es liegt ein dritter unbestimmter Zustand vor, bei dem das Kontrollkästchen abgeblendet und die Option somit nicht verfügbar ist.

  Private Sub CheckBox1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.Click
     Select Case CheckBox1.CheckState
        Case CheckState.Checked
           ' Code for checked state.
        Case CheckState.Unchecked
           ' Code for unchecked state.
        Case CheckState.Indeterminate
           ' Code for indeterminate state.
     End Select 
  End Sub
  

  private void checkBox1_Click(object sender, System.EventArgs e)
  {
     switch(checkBox1.CheckState)
     {
        case CheckState.Checked:
           // Code for checked state.
           break;
        case CheckState.Unchecked:
           // Code for unchecked state.
           break;
        case CheckState.Indeterminate:
           // Code for indeterminate state.
           break;
     }
  }
  

  private:
     void checkBox1_CheckedChanged(System::Object ^ sender,
        System::EventArgs ^ e)
     {
        switch(checkBox1->CheckState) {
           case CheckState::Checked:
              // Code for checked state.
              break;
           case CheckState::Unchecked:
              // Code for unchecked state.
              break;
           case CheckState::Indeterminate:
              // Code for indeterminate state.
              break;
        }
     }
  

  Hinweis:
  Wenn die ThreeState-Eigenschaft auf true festgelegt ist, gibt die Checked-Eigenschaft für Checked und Indeterminate den Wert true zurück.

Siehe auch

Aufgaben

Gewusst wie: Festlegen von Optionen mit CheckBox-Steuerelementen in Windows Forms

Referenz

Übersicht über das CheckBox-Steuerelement (Windows Forms)

CheckBox

Weitere Ressourcen

CheckBox-Steuerelement (Windows Forms)