Propriedade ToggleButton.OnGotFocus (Access)ToggleButton.OnGotFocus property (Access)

Define ou retorna o valor da caixa Ao receber foco na janela Propriedades do objeto especificado.Sets or returns the value of the On Got Focus box in the Properties window of the specified object. String de leitura/gravação.Read/write String.

SintaxeSyntax

expressão. OnGotFocusexpression.OnGotFocus

expressão Uma variável que representa um objeto ToggleButton .expression A variable that represents a ToggleButton 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 GotFocus ocorre quando o objeto recebe o foco.The GotFocus event occurs when the object receives the focus.

O valor OnGotFocus 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 receber foco na janela Propriedades do objeto):The OnGotFocus 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 Got Focus 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 receber foco estiver em branco, o valor da propriedade será uma sequência de caracteres vazia.If the On Got Focus box is blank, the property value is an empty string.

ExemploExample

O exemplo a seguir imprime o valor da propriedade OnGotFocus na janela imediata do botão chamado OK no formulário de entrada de pedidos .The following example prints the value of the OnGotFocus property in the Immediate window for the button named OK on the Order Entry form.

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

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.