Compartilhar via

Como responder a cliques da Caixa de Seleção do Windows Forms

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

Para responder aos cliques de CheckBox

  1. Click No manipulador de eventos, use a Checked propriedade para determinar o estado do controle e execute 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 dá suporte ao evento de clique duplo.

    Observação

    Quando a propriedade AutoCheck está true (o padrão), o CheckBox é automaticamente selecionado ou desmarcado quando clicado. Caso contrário, você deverá definir manualmente a Checked propriedade quando o Click evento ocorrer.

    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. Utilize uma instrução case para consultar o valor da propriedade CheckState e determinar um curso de ação. Quando a ThreeState propriedade é definida como true, a CheckState 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 opção está indisponí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 ThreeState propriedade é definida como true, a Checked propriedade retorna true para ambos Checked e Indeterminate.

Consulte também

  • Last updated on