Freigeben über

Reagieren auf das Klicken auf Kontrollkästchen in Windows Forms

Wenn ein Benutzer auf ein Windows Forms-CheckBox-Steuerelement klickt, tritt das Click-Ereignis auf. Sie können Ihre Anwendung so programmieren, dass abhängig vom Status des Kontrollkästchens eine Aktion ausgefü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 alle 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 versucht, auf das CheckBox-Steuerelement zu doppelklicken, wird jeder Klick separat verarbeitet. d. h., das CheckBox-Steuerelement unterstützt das Doppelklickereignis nicht.

    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.

Um die Vorgehensweise festzulegen, wenn ein Kontrollkästchen angeklickt wird

  1. Verwenden Sie eine Case-Anweisung, um den Wert der CheckState-Eigenschaft abzufragen, um den Aktionsablauf zu bestimmen. Wenn die ThreeState-Eigenschaft auf truefestgelegt ist, kann die CheckState-Eigenschaft einen von drei Werten zurückgeben: das aktivierte Kontrollkästchen, das deaktivierte Kontrollkästchen oder einen dritten, unbestimmten Zustand, bei dem das Kontrollkästchen mit einer gedämpften Darstellung 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 true und Checked den Wert Indeterminate zurück.

Siehe auch