FormClosingEventArgs Classe

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fornece dados para o evento de FormClosing .

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

FormClosingEventArgs(CloseReason, Boolean)

Inicializa uma nova instância da classe FormClosingEventArgs.

Propriedades

Cancel

Obtém ou define um valor que indica se o evento deve ser cancelado.

(Herdado de CancelEventArgs)
CloseReason

Obtém um valor que indica por que o formulário está sendo fechado.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também