Compartilhar via

Como responder a cliques CheckBox dos Windows Forms

  • Artigo

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

Para responder a cliques na caixa de seleção

  1. Click No manipulador de eventos, use a 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 tentar clicar duas vezes no CheckBox controle, cada clique será processado separadamente, ou seja, o CheckBox controle não oferece suporte ao evento de clique duplo.

    Observação

    Quando a AutoCheck propriedade é (o padrão), o CheckBox é automaticamente selecionado ou desmarcado quando é true clicado. Caso contrário, você deve definir manualmente a 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 é clicada

  1. Use uma instrução case para consultar o CheckState valor da propriedade para determinar um curso de ação. Quando a propriedade é definida como true, a propriedade pode retornar três valores possíveis, que representam a caixa que está sendo marcada, a caixa sendo desmarcada ou um terceiro estado indeterminado no qual a caixa é exibida com uma aparência esmaecida para indicar que a ThreeStateCheckState 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 a propriedade é definida como true, a CheckedThreeState propriedade retorna true para ambos Checked e Indeterminate.

Confira também