Partager via


Comment : répondre à un clic du contrôle CheckBox Windows Forms

Chaque fois qu'un utilisateur clique sur un contrôle CheckBox Windows Forms, l'événement Click se produit. Vous pouvez programmer votre application de telle sorte qu'elle effectue une action déterminée par l'état de la case à cocher.

Pour répondre à un clic du contrôle CheckBox

  • Dans le gestionnaire d'événements Click, utilisez la propriété Checked pour déterminer l'état du contrôle et effectuer toute action requise.

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

    Notes

    Si l'utilisateur tente de double-cliquer sur le contrôle CheckBox, chaque clic sera traité séparément ; et cela parce que le contrôle CheckBox ne prend pas en charge l'événement double-clic.

    Notes

    Lorsque la propriété AutoCheck a la valeur true (par défaut), le CheckBox est sélectionné automatiquement ou désactivé lorsqu'il fait l'objet d'un clic. Sinon, vous devez définir manuellement la propriété Checked lorsque se produit l'événement Click.

    Vous pouvez également utiliser le contrôle CheckBox pour déterminer l'action à effectuer.

Pour déterminer l'action à effectuer à la suite d'un clic du contrôle CheckBox

  • Utilisez une instruction case pour connaître la valeur de la propriété CheckState et déterminer l'action requise. Lorsque la propriété ThreeState a la valeur true, la propriété CheckState peut retourner trois valeurs représentant la case activée, la case désactivée ou un troisième état indéterminé dans lequel la case est affichée avec une apparence estompée indiquant que l'option n'est pas 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;
          }
       }
    

    Notes

    Lorsque la propriété ThreeState a la valeur true, la propriété Checked retourne true à la fois pour Checked et Indeterminate.

Voir aussi

Tâches

Comment : définir des options avec les contrôles CheckBox Windows Forms

Référence

Vue d'ensemble du contrôle CheckBox (Windows Forms)

CheckBox

Autres ressources

CheckBox, contrôle (Windows Forms)