Form.Closing Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

Form.cs

Cuidado

Form.OnClosing, Form.OnClosed and the corresponding events are obsolete. Use Form.OnFormClosing, Form.OnFormClosed, Form.FormClosing and Form.FormClosed instead.

Ocorre quando o formulário está fechando.

public:
 event System::ComponentModel::CancelEventHandler ^ Closing;

[System.ComponentModel.Browsable(false)]
[System.Obsolete("Form.OnClosing, Form.OnClosed and the corresponding events are obsolete. Use Form.OnFormClosing, Form.OnFormClosed, Form.FormClosing and Form.FormClosed instead.", false, DiagnosticId="WFDEV004", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public event System.ComponentModel.CancelEventHandler? Closing;

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("Form.OnClosing, Form.OnClosed and the corresponding events are obsolete. Use Form.OnFormClosing, Form.OnFormClosed, Form.FormClosing and Form.FormClosed instead.", false, DiagnosticId="WFDEV004", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
member this.Closing : System.ComponentModel.CancelEventHandler 

Public Custom Event Closing As CancelEventHandler 

Tipo de evento

CancelEventHandler

Atributos

BrowsableAttribute ObsoleteAttribute

Comentários

Cuidado

Em Closing vez disso, o evento é obsoleto; use o FormClosing evento.

O Closing evento ocorre quando o formulário está sendo fechado. Quando um formulário é fechado, todos os recursos criados dentro do objeto são liberados e o formulário é descartado. Se você cancelar esse evento, o formulário permanecerá aberto. Para cancelar o fechamento de um formulário, defina a Cancel propriedade do passado para o CancelEventArgs manipulador de eventos como 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 como DialogResult.Cancel. Você pode substituir o valor atribuído à DialogResult propriedade quando o usuário clicar no botão Fechar definindo a DialogResult propriedade em um manipulador de eventos para o Closing evento do formulário.

Observação

Quando o Close método é chamado em uma Form janela exibida como uma modelagem, você não pode chamar o Show método para tornar o formulário visível, pois os recursos do formulário já foram liberados. Para ocultar um formulário e torná-lo visível, use o Control.Hide método.

Cuidado

O e Form.Closing os Form.Closed eventos não são gerados quando o Application.Exit método é chamado para sair do aplicativo. Se você tiver código de validação em qualquer um desses eventos que devem ser executados, deverá chamar o Form.Close método para 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 filho MDI serão gerados antes que o evento do formulário pai da Closing MDI seja gerado. Além disso, os Closed eventos de todos os formulários filho MDI são gerados antes que o Closed evento do formulário pai da MDI seja gerado. Cancelar o Closing evento de um formulário filho MDI não impede que o Closing evento do formulário pai da MDI seja gerado. No entanto, cancelar o evento será definido como true a Cancel propriedade do CancelEventArgs que é passado como um parâmetro para o formulário pai. Para forçar o fechamento de todos os formulários pai e filho da MDI, defina a Cancel propriedade false no formulário pai do MDI.

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

Confira também

• IsMdiContainer
• OnClosing(CancelEventArgs)