Freigeben über


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

Wenn ein Benutzer auf ein Windows Forms-Steuerelement CheckBox klickt, tritt das Click-Ereignis auf. Sie können Ihre Anwendung so programmieren, dass abhängig vom Status des Kontrollkästchens eine Aktion durchgeführt wird.

So reagieren Sie auf CheckBox-Klicks

  1. Verwenden Sie im Click-Ereignishandler die Checked-Eigenschaft, um den Zustand des Steuerelements zu bestimmen und die ggf. erforderlichen Aktionen auszuführen.

    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 jeder Klick getrennt verarbeitet. d. h., das Doppelklickereignis wird vom CheckBox-Steuerelement nicht unterstützt.

    Hinweis

    Wenn die AutoCheck-Eigenschaft true ist (Standardeinstellung), wird die CheckBox-Eigenschaft durch einen Klick automatisch aus- oder abgewählt. Andernfalls müssen Sie die Checked-Eigenschaft manuell festlegen, wenn das Click-Ereignis auftritt.

    Sie können auch das CheckBox-Steuerelement verwenden, um den Aktionsablauf zu bestimmen.

So bestimmen Sie den Aktionsablauf beim Klicken auf ein Kontrollkästchen

  1. Verwenden Sie eine Case-Anweisung, um den Wert der CheckState-Eigenschaft abzufragen, um den Aktionsablauf zu bestimmen. Wenn die ThreeState-Eigenschaft auf true festgelegt ist, kann die CheckState-Eigenschaft mögliche Werte zurückgeben, die den Zustand des Kontrollkästchen darstellen: aktiviert, deaktiviert oder ein dritter unbestimmter Zustand, in dem das Kontrollkästchen abgeblendet angezeigt wird, um anzugeben, dass die Option 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.

Weitere Informationen