Compartilhar via

Evento CheckBox.Click (Access)

  • Artigo

O evento Click ocorre quando um usuário pressiona e depois libera um botão do mouse sobre um objeto.

Sintaxe

expressão. Clique

Expressão Uma variável que representa um objeto CheckBox .

Comentários

Esse evento não se aplica a caixas de seleção, botões de opção ou botões de alternância em um grupo de opções. Aplica-se somente ao grupo de opções propriamente dito.

Esse evento aplica-se a um controle que contém um hiperlink.

Para executar um macro ou procedimento de evento quando esse evento ocorrer, defina a propriedade OnClick com o nome da macro ou como [procedimento do evento].

Para um controle, esse evento ocorre quando o usuário:

  • Clica em um controle com o botão esquerdo do mouse. Clicar em um controle com o botão direito ou do meio do mouse não dispara esse evento.

  • Clicar em um controle que contém dados hiperlink com o botão esquerdo do mouse. Clicar em um controle com o botão direito ou do meio do mouse não aciona esse evento. Quando o usuário move o ponteiro do mouse sobre um controle contendo dados hiperlink, as alterações do ponteiro do mouse em um ícone de "mão". Quando o usuário clica no botão do mouse, o hiperlink é ativado e, em seguida, o evento Click ocorre.

  • Seleciona um item em uma caixa de combinação ou caixa de lista, pressionando as teclas de seta e pressionando a tecla Enter ou clicando no botão mouse.

  • Pressiona a barra de espaços quando um botão de comando, marcar caixa, botão de opção ou botão de alternância tem o foco.

  • Pressiona a tecla Enter em um formulário que tem um botão de comando cuja propriedade Default está definida como Sim.

  • Pressiona a tecla Esc em um formulário que tem um botão de comando cuja propriedade Cancel está definida como Sim.

  • Pressiona a tecla de acesso de um controle. Por exemplo, se a propriedade Caption de um botão de comando estiver definida como &Go, pressionar Alt+G disparará o evento.

Normalmente, um procedimento de evento Click ou macro é anexado a um botão de comando para executar comandos e ações do tipo comando. Para os outros controles aplicáveis, use este evento para disparar ações em resposta a uma das ocorrências discutidas anteriormente neste tópico.

Use uma ação CancelEvent em uma macro DblClick para cancelar o segundo evento Clique . Para obter mais informações, consulte o tópico de evento DblClick .

Para diferenciar os botões esquerdo, direita e do meio do mouse, utilize os eventos MouseDown e MouseUp.

Exemplo

No exemplo a seguir, o procedimento de evento Clique é anexado à caixa marcar ReadOnly. O procedimento de evento define as propriedades Habilitadas e Bloqueadas de outro controle no formulário, a caixa de texto Quantidade . Quando a caixa de seleção for clicada, o procedimento de evento verificará se a caixa de seleção está sendo marcada ou desmarcada e definirá as propriedades da caixa de texto de forma condizente, habilitando ou desabilitando a edição.

Para experimentar o exemplo, adicione o procedimento de evento a seguir a um formulário que contém uma caixa de marcar chamada ReadOnly e uma caixa de texto chamada Quantidade.

Private Sub ReadOnly_Click() 
 With Me!Amount 
 If Me!ReadOnly = True Then ' If checked. 
 .Enabled = False ' Disable editing. 
 .Locked = True 
 Else ' If cleared. 
 .Enabled = True ' Enable editing. 
 .Locked = False 
 End If 
 End With 
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.