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.
• Desativar um aplicativo clicando com o botão direito do mouse no botão da barra de tarefas do aplicativo e escolhendo 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

Ao criar macros ou procedimentos de evento para eventos relacionados ao evento Descarregar , como Desativar e LostFocus, certifique-se de que eles não entrem em conflito (por exemplo, certifique-se de que você não faça com que algo aconteça em uma macro ou procedimento cancelado em outra) e que eles 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 exibição Formulário, feche o formulário para exibir a caixa de diálogo e escolha 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.