Evento Form.Open (Access)

O evento Open ocorre quando um formulário é aberto, mas antes de o primeiro registro ser exibido.

Sintaxe

expressão. Abrir (Cancelar)

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

Parâmetros

Comentários

Ao executar uma macro ou um procedimento de evento quando ocorre o evento Open de um formulário, você pode fechar outra janela ou mover o foco para um determinado controle em um formulário. É possível também executar uma macro ou um procedimento de evento que solicite informações necessárias antes de o formulário ou relatório ser aberto ou impresso.

Por exemplo, uma macro ou procedimento de evento Open pode abrir uma caixa de diálogo personalizada para que o usuário insira os critérios para filtrar o conjunto de registros a serem exibidos em um formulário ou o intervalo de dados a ser incluído em um relatório.

O evento Abrir não ocorre quando ativa um formulário que já está aberto; por exemplo, quando muda para o formulário a partir de outra janela no Microsoft Access ou utiliza a ação AbrirFormulário numa macro para colocar o formulário aberto na parte superior. Por outro lado, o evento Activate ocorre nessas situações.

Quando um formulário é aberto fundamentado em uma consulta de base, o Microsoft Access executa essa consulta para o formulário antes de executar a macro ou procedimento de evento Open.

Se a sua aplicação puder ter mais do que um formulário carregado de cada vez, utilize os eventos Ativar e Desativar em vez do evento Abrir para apresentar e ocultar barras de ferramentas personalizadas quando o foco mudar para um formulário diferente.

O evento Abrir ocorre antes do evento Carregar , que é acionado quando um formulário é aberto e os respetivos registos são apresentados.

Assim que você abre um formulário, os eventos a seguir ocorrem nesta ordem:

Abrir → carregar → Redimensionar → Ativar → atual

O evento Fechar ocorre após o evento Descarregar , que é acionado após o formulário ser fechado, mas antes de ser removido do ecrã.

Quando você fecha um formulário, os eventos a seguir ocorrem nesta ordem:

Descarregar → Desativar → Fechar

Quando o evento Fechar ocorre, pode abrir outra janela ou pedir o nome do utilizador para fazer uma entrada de registo que indique quem utilizou o formulário ou relatório.

Se estiver a tentar decidir se pretende utilizar o evento Abrir ou Carregar para o seu procedimento de macro ou evento, uma diferença significativa é que o evento Abrir pode ser cancelado, mas o evento Carregar não pode. Por exemplo, se estiver a criar dinamicamente uma origem de registos para um formulário num procedimento de evento para o evento Abrir do formulário, pode cancelar a abertura do formulário se não existirem registos para apresentar. Da mesma forma, o evento Unload pode ser cancelado, mas o evento Close não.

Exemplo

O exemplo seguinte mostra como pode cancelar a abertura de um formulário quando o utilizador escolhe um botão Não . Uma caixa de mensagem pede para o usuário inserir detalhes do pedido. Se o utilizador escolher Não, o formulário Detalhes da Encomenda não é aberto.

Para testar o exemplo, adicione o procedimento de evento a seguir a um formulário.

Private Sub Form_Open(Cancel As Integer) 
 Dim intReturn As Integer 
 intReturn = MsgBox("Enter order details now?", vbYesNo) 
 Select Case intReturn 
 Case vbYes 
 ' Open Order Details form. 
 DoCmd.OpenForm "Order Details" 
 Case vbNo 
 MsgBox "Remember to enter order details by 5 P.M." 
 Cancel = True ' Cancel Open event. 
 End Select 
End Sub

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.