Compartilhar via

Evento CommandButton.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 CommandButton .

Comentários

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.

Somente para um botão de comando, o Microsoft Access executa o procedimento de macro ou evento especificado pela propriedade OnClick quando o usuário escolhe o botão de comando pressionando a tecla Enter ou uma chave de acesso. A macro ou o procedimento de evento é executada uma vez. Se quiser que a macro ou o procedimento de evento seja executada repetidamente durante o pressionamento do botão de comando, defina sua propriedade AutoRepeat como Sim. Para outros tipos de controle, você deverá clicar no controle usando o botão do mouse para acionar o evento Click.

O evento Click para um botão de comando ocorre quando você escolhe o botão de comando. Além disso, se o botão de comando ainda não tiver o foco quando você o escolher, os eventos Enter e GotFocus para o botão de comando ocorrerão antes do evento Click.

Clicar duas vezes em um controle faz com que os eventos DblClick e Click ocorram. Para botões de comando, clicar duas vezes dispara os seguintes eventos nesta ordem:

MouseDown → MouseUp → Click → DblClick → Click

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.

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.