Partilhar via


Como: Responder a cliques no CheckBox de formulários de Windows

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

Para responder a cliques de CheckBox

  • No Click 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:

    Caso o usuário tente clicar duas vezes o CheckBox controle, cada clicar será processada separadamente, ou seja, o CheckBox controle não oferece suporte ao evento de clicar duplo.

    Observação:

    Quando o AutoCheck propriedade é true (padrão), o CheckBox é automaticamente marcada ou desmarcada ao ser clicado. Caso contrário, você deve conjunto manualmente o Checked propriedade quando o Click evento ocorre.

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

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

  • Usar uma demonstrativo caso para consultar o valor de CheckState propriedade para determinar um curso de ação. Quando o ThreeState propriedade é conjunto para 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 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 propriedade estiver definida como true, o Checked propriedade para retornar true para ambos Checked e Indeterminate.

Consulte também

Tarefas

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

Referência

Controle CheckBox visão geral (Windows Forms)

CheckBox

Outros recursos

Controle CheckBox (Windows Forms)