Compartilhar via

Evento Form.Unload (Access)

O evento Unload ocorre depois que um formulário é fechado, mas antes de ele ser removido da tela. Quando o formulário é recarregado, o Microsoft Access exibe novamente o formulário e reinicializa o conteúdo de todos os seus controles.

Sintaxe

expressão. Descarregar (Cancelar)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Cancel Obrigatório Integer Defina como True para cancelar o evento Unload.

Comentários

Para executar um macro ou procedimento de evento quando esses eventos ocorrerem, defina a propriedade OnUnload com o nome da macro ou como [procedimento do evento].

O evento Unload é gerado por ações do usuário, como:

  • Fechar o formulário.
  • Executar a ação Fechar em uma macro.
  • Para sair de uma aplicação, clique com o botão direito do rato no botão da barra de tarefas da aplicação e, em seguida, selecione Fechar.
  • Sair do Windows enquanto um aplicativo está sendo executado.

Executando uma macro ou um procedimento de evento quando o evento Unload de um formulário ocorrer, você pode verificar que o formulário deve ser descarregado ou especificar ações que devem ocorrer quando o formulário for descarregado. Você também pode abrir outro formulário ou exibir uma caixa de diálogo solicitando o nome do usuário para realizar uma entrada de log, indicando quem utilizou o formulário.

Quando você fechar um formulário, os eventos ocorrerão nesta ordem:

Descarregar → Desativar → Fechar

O evento Unload ocorre antes do evento Close. O evento Unload pode ser cancelado, mas o evento Close não.

Observação

Quando cria macros ou procedimentos de eventos relacionados com o evento Descarregar , como Desativar e LostFocus, certifique-se de que não entram em conflito (por exemplo, certifique-se de que não faz com que algo aconteça numa macro ou procedimento cancelado noutra) e que não causam eventos em cascata.

Exemplo

Este exemplo pede que o usuário verifique se o formulário deve ser fechado.

Para testar o exemplo, adicione o procedimento de evento a seguir a um formulário. Na vista Formulário, feche o formulário para apresentar a caixa de diálogo e, em seguida, selecione Sim ou Não.

Private Sub Form_Unload(Cancel As Integer) 
 If MsgBox("Close form?", vbYesNo) = vbYes Then 
 Exit Sub 
 Else 
 Cancel = True 
 End If 
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.

  • Last updated on