FormClosingEventArgs Classe

Definição

public ref class FormClosingEventArgs : System::ComponentModel::CancelEventArgs

public class FormClosingEventArgs : System.ComponentModel.CancelEventArgs

type FormClosingEventArgs = class
    inherit CancelEventArgs

Public Class FormClosingEventArgs
Inherits CancelEventArgs

Herança

Object

EventArgs

CancelEventArgs

FormClosingEventArgs

Exemplos

O exemplo de código a seguir demonstra o uso desse tipo. No exemplo, um manipulador de eventos relata a ocorrência do FormClosing evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir ShowConsole.WriteLine ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo Form chamada Form1. Em seguida, verifique se o manipulador de eventos está associado ao FormClosing evento.

private void Form1_FormClosing(Object sender, FormClosingEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "CloseReason", e.CloseReason );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "FormClosing Event" );
}

Private Sub Form1_FormClosing(sender as Object, e as FormClosingEventArgs) _ 
     Handles Form1.FormClosing

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "CloseReason", e.CloseReason)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"FormClosing Event")

End Sub

Comentários

O FormClosing evento ocorre pouco antes de um formulário ser fechado, seja pelo usuário, por meio da interface do usuário (interface do usuário) ou programaticamente, por meio de chamadas para métodos como Close na Form classe ou Exit na Application classe .

Se um formulário tiver qualquer formulário filho ou de propriedade, um FormClosing evento também será gerado para cada um deles. Se qualquer um dos formulários cancelar o evento, nenhum dos formulários será fechado. Portanto, os eventos correspondentes FormClosed não são enviados para nenhum dos formulários.

A FormClosingEventArgs classe fornece dados para esse evento. Dois membros importantes são as Cancel propriedades e CloseReason . O evento pode ser cancelado definindo a Cancel propriedade como true. A CloseReason propriedade fornece um motivo pelo qual o formulário está sendo fechado.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• Form
• FormClosing
• Close()
• Exit()
• CloseReason
• FormClosingEventHandler
• FormClosedEventArgs