Propriedade Form. OnCurrent (Access)Form.OnCurrent property (Access)

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

SintaxeSyntax

expressão. OnCurrentexpression.OnCurrent

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 Current ocorrerá quando o foco se mover para um registro, tornando-o o registro atual, ou quando o formulário for atualizado ou quando sua consulta for repetida.The Current event occurs when the focus moves to a record, making it the current record, or when the form is refreshed or requeried.

O **** valor OnCurrent 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 no atual , na janela Propriedades do formulário):The OnCurrent 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 Current box in the form'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 No Atual estiver vazia, o valor da propriedade será uma sequência vazia.If the On Current box is blank, the property value is an empty string.

ExemploExample

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

Forms("Order Entry").OnCurrent = "Current_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.