Como: Responder a cliques de caixa de seleção de formulários do Windows

Sempre que um usuário clica um Windows Forms CheckBox o controle, o Click evento ocorre. Você pode programar seu aplicativo para executar alguma ação, dependendo do estado da caixa de seleção.

Para responder a cliques no CheckBox

• No Click o manipulador de eventos, use o Checked propriedade para determinar o estado do controle e executar qualquer ação necessária.

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

  Observação
  Se o usuário tenta clique duas vezes o CheckBox o controle, cada clique será processada separadamente; ou seja, o CheckBox controle não dá suporte a eventos de clique duplo.

  Observação
  Quando o AutoCheck é a propriedade true (padrão), o CheckBox é automaticamente selecionada ou desmarcada quando é clicado. Caso contrário, você deve definir manualmente a Checked propriedade quando o Click evento ocorre.

  Você também pode usar o CheckBox o controle para determinar um curso de ação.

Para determinar um curso de ação quando uma caixa de seleção é clicado

• Use uma instrução case para consultar o valor de CheckState propriedade para determinar um curso de ação. Quando o ThreeState for definida como true, o CheckState propriedade pode retornar três valores possíveis, representam a caixa de verificação, a caixa sendo desmarcado ou um terceiro estado indeterminado no qual a caixa é exibida com uma aparência esmaecida para indicar a opção não está disponível.

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

  Observação
  Quando o ThreeState for definida como true, o Checked retorna a propriedade true para ambos Checked e Indeterminate.

Consulte também

Tarefas

Como: Definir opções com controles CheckBox do Windows Forms

Referência

Visão geral do controle CheckBox (Windows Forms)

CheckBox

Outros recursos

Controle de caixa de seleção (Windows Forms)