Cómo: Responder a clics en casillas de formularios Windows Forms

Actualización: noviembre 2007

Cada vez que un usuario hace clic en un control CheckBox de formularios Windows Forms, se produce el evento Click. Puede programar la aplicación para que ejecute una acción determinada, dependiendo del estado de la casilla.

Para responder a eventos de clic en controles CheckBox

• En el controlador de eventos Click, utilice la propiedad Checked para determinar el estado del control y realizar las acciones necesarias.

  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";
        }
     }
  

  Nota:
  Si el usuario intenta hacer doble clic en el control CheckBox, cada clic se procesará por separado; es decir, el control CheckBox no admite el evento doble clic.

  Nota:
  Cuando la propiedad AutoCheck es true (el valor predeterminado), se selecciona CheckBox automáticamente o se borra cuando se hace clic en ella. En caso contrario, será necesario establecer manualmente la propiedad Checked cuando se produzca el evento Click.

  También puede utilizar el control CheckBox para determinar una línea de acción.

Para determinar una línea de acción cuando se hace clic en una casilla

• Utilice una instrucción case para consultar el valor de la propiedad CheckState y establecer una línea de acción. Cuando la propiedad ThreeState se establece en true, la propiedad CheckState puede devolver tres posibles valores, que corresponden a la casilla activada, la casilla desactivada y un tercer estado indeterminado, en el que la casilla se muestra atenuada para indicar que la opción no está disponible.

  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;
        }
     }
  

  Nota:
  Cuando la propiedad ThreeState se establece en true, la propiedad Checked devuelve true tanto para Checked como para Indeterminate.

Vea también

Tareas

Cómo: Establecer opciones con los controles CheckBox de formularios Windows Forms

Referencia

Información general sobre el control CheckBox (formularios Windows Forms)

CheckBox

Otros recursos

CheckBox (Control, formularios Windows Forms)