Form.Closing Evento

Definição

Ocorre quando o formulário está a fechar.

public:
 event System::ComponentModel::CancelEventHandler ^ Closing;
public event System.ComponentModel.CancelEventHandler Closing;
[System.ComponentModel.Browsable(false)]
public event System.ComponentModel.CancelEventHandler Closing;
member this.Closing : System.ComponentModel.CancelEventHandler 
[<System.ComponentModel.Browsable(false)>]
member this.Closing : System.ComponentModel.CancelEventHandler 
Public Custom Event Closing As CancelEventHandler 

Tipo de Evento

Atributos

Observações

Atenção

O Closing evento está obsoleto; use o FormClosing evento em vez disso.

O Closing evento ocorre enquanto o formulário está a ser fechado. Quando um formulário é fechado, todos os recursos criados dentro do objeto são libertados e o formulário é descartado. Se cancelar este evento, o formulário permanece aberto. Para cancelar o fecho de um formulário, defina a Cancel propriedade do CancelEventArgs passado ao seu gestor de eventos para true.

Quando um formulário é exibido como uma caixa de diálogo modal, clicar no botão Fechar (o botão com um X no canto superior direito do formulário) faz com que o formulário fique oculto e a DialogResult propriedade seja definida para DialogResult.Cancel. Pode sobrescrever o valor atribuído à DialogResult propriedade quando o utilizador clica no botão Fechar , definindo a DialogResult propriedade num gestor de eventos para o Closing evento do formulário.

Note

Quando o Close método é chamado numa Form janela exibida como uma janela sem modos, não pode chamar o Show método para tornar o formulário visível, porque os recursos do formulário já foram libertados. Para esconder uma forma e depois torná-la visível, use o Control.Hide método.

Atenção

Os Form.Closed eventos e Form.Closing não são apresentados quando o Application.Exit método é chamado para sair da sua candidatura. Se tiver código de validação em algum destes eventos que deve ser executado, deve chamar o Form.Close método de cada formulário aberto individualmente antes de chamar o Exit método.

Se o formulário for um formulário pai MDI, os Closing eventos de todos os formulários filhos MDI são levantados antes de o evento do Closing formulário pai MDI ser levantado. Além disso, os Closed eventos de todas as formas filhas MDI são levantados antes de o Closed evento da forma mãe MDI ser levantado. Cancelar o Closing evento de um formulário filho MDI não impede que o Closing evento do formulário pai MDI seja elevado. No entanto, cancelar o evento será definido para true a Cancel propriedade de CancelEventArgs , que é passada como parâmetro à forma principal. Para forçar o encerramento de todos os formulários pai e filho do MDI, defina a Cancel propriedade como false no formulário pai do MDI.

Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.

Aplica-se a

Ver também