Procedura: rispondere alla selezione di controlli CheckBox Windows Form

Aggiornamento: novembre 2007

Se si fa clic su un controllo CheckBox Windows Form, viene generato un evento Click. È possibile programmare l'applicazione per eseguire una data azione in base allo stato della casella di controllo.

Per programmare la risposta agli eventi Click dei controlli CheckBox

• Nel gestore eventi Click utilizzare la proprietà Checked per determinare lo stato del controllo ed eseguire le operazioni eventualmente necessarie.

  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:
  Se si fa doppio clic sul controllo CheckBox, ogni clic viene elaborato singolarmente, dato che il controllo CheckBox non supporta l'evento generato dal doppio clic.

  Nota:
  Quando la proprietà AutoCheck è impostata su true (impostazione predefinita), il controllo CheckBox viene selezionato o deselezionato automaticamente quando ci si fa clic sopra. In caso contrario è necessario impostare manualmente la proprietà Checked quando viene generato l'evento Click.

  È inoltre possibile utilizzare il controllo CheckBox per stabilire un'operazione da eseguire.

Per stabilire un'operazione da eseguire quando si seleziona una casella di controllo

• Utilizzare un'istruzione per interrogare il valore della proprietà CheckState e stabilire un'azione da eseguire. Se la proprietà ThreeState è impostata su true, la proprietà CheckState può restituire tre valori possibili che rappresentano la casella selezionata, la casella deselezionata o un terzo stato non definito in cui la casella viene visualizzata come inattiva per indicare che l'opzione non è disponibile.

  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:
  Quando la proprietà ThreeState è impostata su true, la proprietà Checked restituisce true sia per Checked che per Indeterminate.

Vedere anche

Attività

Procedura: impostare opzioni con i controlli CheckBox di Windows Form

Riferimenti

Cenni preliminari sul controllo CheckBox (Windows Form)

CheckBox

Altre risorse

Controllo CheckBox (Windows Form)