Evento de clique

Ocorre em um dos dois casos:

  • O usuário clica em um controle com o mouse.
  • O usuário seleciona definitivamente um valor para um controle com mais de um valor possível.

Sintaxe

Para MultiPage, TabStrip:
Subobjeto privado _Click(indexAs Long)

Para todos os outros controles:
Subobjeto privado _Click( )

A sintaxe do evento Click tem estas partes:

Sair Descrição
objeto Obrigatório. Um objeto válido.
index Obrigatório. O índice da página ou guia em uma MultiPage ou TabStrip associada a esse evento.

Comentários

Dos dois casos em que o evento Click ocorre, o primeiro caso se aplica a CommandButton, Frame, Image, Label, ScrollBar e SpinButton.

O segundo caso se aplica a CheckBox, ComboBox, ListBox, MultiPage, TabStrip e ToggleButton. Ela também se aplica a um OptionButton quando o valor é alterado para True.

Veja a seguir exemplos de ações que iniciam o evento Click :

  • Clicking a blank area of a form or a disabled control (other than a list box) on the form.

  • Clicking a CommandButton. Se o botão de comando ainda não tiver o foco, o evento Enter ocorrerá antes do evento Click .

  • Pressing the SPACEBAR when a CommandButton has the focus.

  • Clicando em um controle.

  • Pressing ENTER on a form that has a command button whose Default property is set to True, as long as no other command button has the focus.

  • Pressing ESC on a form that has a command button whose Cancel property is set to True, as long as no other command button has the focus.

  • Pressionando a tecla aceleradora de um controle.

Quando o evento Click resulta do clique em um controle, a sequência de eventos que leva ao evento Click é:

  1. MouseDown
  2. MouseUp
  3. Clique em

For some controls, the Click event occurs when the Value property changes. No entanto, usar o evento Change é a técnica preferencial para detectar um novo valor para uma propriedade. Veja a seguir exemplos de ações que iniciam o evento Click devido à atribuição de um novo valor a um controle:

  • Clicando em uma página ou guia diferente em uma MultiPage ou TabStrip. A propriedade Value para esses controles reflete a Pageou Guia atual. Clicar na página ou guia atual não altera o valor do controle e não inicia o evento Click .

  • Clicar em CheckBox ou ToggleButton, pressionar a barra de espaços quando um desses controles tiver o foco, pressionar a tecla aceleradora para um desses controles ou alterar o valor do controle no código.

  • Alterando o valor de um OptionButton para True. Definir um OptionButton em um grupo como True define todos os outros botões do grupo como False, mas o evento Click ocorre somente para o botão cujo valor é alterado para True.

  • Selecionar um valor para um ComboBox ou ListBox para que ele corresponda inquestionavelmente a um item na lista suspensa do controle. For example, if a list is not sorted, the first match for characters typed in the edit region may not be the only match in the list, so choosing such a value does not initiate the Click event. In a sorted list, you can use entry-matching to ensure that a selected value is a unique match for text the user types.

The Click event is not initiated when Value is set to Null.

Observação

Clicar altera o valor de um controle e, portanto, inicia o evento Click . Quando você clica com o botão direito do mouse, o valor do controle não é alterado, portanto, ele não inicia o evento Click .

Confira também

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.