Propriedade CommandButton.OnClick (Access)

Define ou retorna o valor da caixa Ao clicar na janela Propriedades. String de leitura/gravação.

Sintaxe

mais simples. Ao clicar

expressão Uma variável que representa um objeto CommandButton .

Comentários

Esta propriedade é útil para alterar programaticamente a ação que o Microsoft Access executa quando um evento é disparado. Por exemplo, você pode alterar os parâmetros de uma expressão entre as chamadas de eventos ou alternar entre um procedimento de evento e uma expressão ou uma macro, dependendo das circunstâncias nas quais o evento foi disparado.

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

O valor OnClick será um dos seguintes, dependendo da seleção escolhida na janela Escolher construtor (acessada escolhendo o botão Construir ao lado da caixa Ao clicar na janela Propriedades do objeto):

• Se você escolher o Construtor de Expressões, o valor será =expression, onde expression é a expressão da janela do Construtor de Expressões.

• Se você escolher o Construtor de Macros, o valor será o nome da macro.

• Se você escolher Construtor de Códigos, o valor será [Event Procedure].

Se a caixa Ao clicar estiver em branco, o valor da propriedade será uma sequência de caracteres vazia.

Exemplo

O exemplo a seguir associa o evento Click ao procedimento de evento de OK_Click para o botão denominado OK no formulário Order Entry , se não houver nenhuma associação no momento.

With Forms("Order Entry").Controls("OK") 
 If .OnClick = "" Then 
 .OnClick = "[Event Procedure]" 
 End If 
End With 

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.