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.