Propriedade Form. OnActivate (Access)Form.OnActivate property (Access)

Define ou retorna o valor da caixa Ativar na janela Propriedades de um formulário ou relatório.Sets or returns the value of the On Activate box in the Properties window of a form or report. String de leitura/gravação.Read/write String.

SintaxeSyntax

expressão. **** OnActivateexpression.OnActivate

expressão Uma variável que representa um objeto Form.expression A variable that represents a Form object.

ComentáriosRemarks

Essa propriedade é útil para alterar programaticamente a ação que o Microsoft Access executa quando um evento é disparado.This property is helpful for programmatically changing the action that Microsoft Access takes when an event is triggered. 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.For example, between event calls you may want to change an expression's parameters, or switch from an event procedure to an expression or macro, depending on the circumstances under which the event was triggered.

O evento Activate ocorre quando o formulário ou relatório recebe o foco e se torna a janela ativa.The Activate event occurs when the form or report receives the focus and becomes the active window.

O **** valor OnActivate será um dos seguintes, dependendo da seleção escolhida na janela escolher Construtor (acessada quando você escolher o botão construir ao lado da caixa ao ativar na janela Propriedades do objeto):The OnActivate value will be one of the following, depending on the selection chosen in the Choose Builder window (accessed by choosing the Build button next to the On Activate box in the object's Properties window):

  • Se você escolher o construtor de expressões, o valor será =expressão, onde expressão é a expressão da janela do construtor de expressões.If you choose Expression Builder, the value will be =expression, where expression is the expression from the Expression Builder window.

  • Se você escolher Construtor de macros, o valor será o nome da macro.If you choose Macro Builder, the value is the name of the macro.

  • Se você escolher o construtor de código, o valor será [procedimento do evento].If you choose Code Builder, the value will be [Event Procedure].

Se a caixa Ao ativar estiver vazia, o valor da propriedade é uma sequência vazia.If the On Activate box is blank, the property value is an empty string.

ExemploExample

O exemplo a seguir associa o evento Activate à macro Activate_Macro para o formulário de entrada de pedidos .The following example associates the Activate event with the macro Activate_Macro for the Order Entry form.

Forms("Order Entry").OnActivate = "Activate_Macro"

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.