Propriedade CommandButton.OnPush (Access)

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

Sintaxe

expressão. OnPush

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 realiza quando um evento é acionado. 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.

Embora o nome dessa propriedade seja OnPush, a definição dessa propriedade-la define realmente o valor da caixa Ao clicar.

O valor OnPush será um dos seguintes, consoante a seleção escolhida na janela Escolher Construtor (acedido ao selecionar o botão Criar junto à caixa Ao Clicar na janela Propriedades do botão de comando):

• Se escolher Construtor de Expressões, o valor será =expressão, em que expressão é a expressão da janela do Construtor de Expressões.

• Se escolher Construtor de Macros, o valor é o nome da macro.

• Se escolher o Construtor de Código, o valor será [Procedimento de Evento].

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

Exemplo

O exemplo seguinte imprime o valor da propriedade OnPush na janela Imediato do botão OK no formulário Entrada de Encomenda .

Debug.Print Forms("Order Entry").Controls("OK").OnPush

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.