FormClosingEventArgs Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Proporciona datos para el evento FormClosing.

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

public class FormClosingEventArgs : System.ComponentModel.CancelEventArgs

type FormClosingEventArgs = class
    inherit CancelEventArgs

Public Class FormClosingEventArgs
Inherits CancelEventArgs

Herencia

Object

EventArgs

CancelEventArgs

FormClosingEventArgs

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este tipo. En el ejemplo, un controlador de eventos informa sobre la aparición del FormClosing evento. Este informe le ayuda a aprender cuándo se produce el evento y puede ayudarle a depurar. Para informar sobre varios eventos o eventos que se producen con frecuencia, considere la posibilidad de reemplazar Show por Console.WriteLine o anexar el mensaje a una línea TextBoxmúltiple.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de tipo Form denominada Form1. A continuación, asegúrese de que el controlador de eventos está asociado al 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

Comentarios

El FormClosing evento se produce justo antes de cerrar un formulario, ya sea por el usuario, a través de la interfaz de usuario (UI) o mediante programación, mediante llamadas a métodos como Close en la Form clase o Exit en la Application clase .

Si un formulario tiene formularios secundarios o de propiedad, también se genera un FormClosing evento para cada uno. Si alguno de los formularios cancela el evento, ninguno de los formularios se cierra. Por lo tanto, los eventos correspondientes FormClosed no se envían a ninguno de los formularios.

La FormClosingEventArgs clase proporciona datos para este evento. Dos miembros importantes son las Cancel propiedades y CloseReason . El evento se puede cancelar estableciendo la Cancel propiedad en true. La CloseReason propiedad proporciona un motivo por el que se cierra el formulario.

Constructores

FormClosingEventArgs(CloseReason, Boolean)

Inicializa una nueva instancia de la clase FormClosingEventArgs.

Propiedades

Cancel	Obtiene o establece un valor que indica si se debe cancelar el evento. (Heredado de CancelEventArgs)
CloseReason	Obtiene un valor que indica por qué se cierra el formulario.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

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