Window.Closing Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre logo após Close() ser chamado e pode ser usado para cancelar o fechamento de uma janela.
public:
event System::ComponentModel::CancelEventHandler ^ Closing;
public event System.ComponentModel.CancelEventHandler Closing;
member this.Closing : System.ComponentModel.CancelEventHandler
Public Custom Event Closing As CancelEventHandler
Tipo de evento
Exceções
Visibility é definido, ou Show(), ShowDialog() ou Close() é chamado durante o fechamento de uma janela.
Exemplos
O exemplo a seguir demonstra um Window que determina se ele precisa de intervenção do usuário para fechar.
<Window
x:Class="CSharp.DataWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Closing="DataWindow_Closing"
>
<Grid>
<TextBox Name="documentTextBox" AcceptsReturn="True" AcceptsTab="True" TextChanged="documentTextBox_TextChanged"></TextBox>
</Grid>
</Window>
using System; // EventArgs
using System.ComponentModel; // CancelEventArgs
using System.Windows; // window
namespace CSharp
{
public partial class DataWindow : Window
{
// Is data dirty
bool isDataDirty = false;
public DataWindow()
{
InitializeComponent();
}
void documentTextBox_TextChanged(object sender, EventArgs e)
{
this.isDataDirty = true;
}
void DataWindow_Closing(object sender, CancelEventArgs e)
{
MessageBox.Show("Closing called");
// If data is dirty, notify user and ask for a response
if (this.isDataDirty)
{
string msg = "Data is dirty. Close without saving?";
MessageBoxResult result =
MessageBox.Show(
msg,
"Data App",
MessageBoxButton.YesNo,
MessageBoxImage.Warning);
if (result == MessageBoxResult.No)
{
// If user doesn't want to close, cancel closure
e.Cancel = true;
}
}
}
}
}
Imports System ' EventArgs
Imports System.ComponentModel ' CancelEventArgs
Imports System.Windows ' window
Namespace VisualBasic
Partial Public Class DataWindow
Inherits Window
' Is data dirty
Private isDataDirty As Boolean = False
Public Sub New()
InitializeComponent()
End Sub
Private Sub documentTextBox_TextChanged(ByVal sender As Object, ByVal e As EventArgs)
Me.isDataDirty = True
End Sub
Private Sub DataWindow_Closing(ByVal sender As Object, ByVal e As CancelEventArgs)
MessageBox.Show("Closing called")
' If data is dirty, notify user and ask for a response
If Me.isDataDirty Then
Dim msg As String = "Data is dirty. Close without saving?"
Dim result As MessageBoxResult = MessageBox.Show(msg, "Data App", MessageBoxButton.YesNo, MessageBoxImage.Warning)
If result = MessageBoxResult.No Then
' If user doesn't want to close, cancel closure
e.Cancel = True
End If
End If
End Sub
End Class
End Namespace
Comentários
Closing pode ser manipulado para detectar quando uma janela está sendo fechada (por exemplo, quando Close é chamada). Além disso, Closing pode ser usado para impedir o fechamento de uma janela. Para impedir que uma janela seja fechada, você pode definir a Cancel propriedade do CancelEventArgs argumento como true
.
O Closing evento é acionado quando Close é chamado, se o botão Fechar de uma janela for clicado ou se o usuário pressionar ALT+F4.
Se uma janela de propriedade tiver sido aberta pela janela do proprietário usando Showe a janela do proprietário for fechada, o evento da janela de Closing propriedade não será acionado. Se o proprietário de uma janela estiver fechado (consulte Owner), Closing não será gerado na janela de propriedade.
Se Shutdown for chamado, o Closing evento para cada janela será gerado. No entanto, se Closing for cancelado, o cancelamento será ignorado.
Se uma sessão terminar porque um usuário faz logoff ou desliga, Closing não é gerado; manipule SessionEnding para implementar o código que cancela o fechamento do aplicativo.
Se você quiser mostrar e ocultar uma janela várias vezes durante o tempo de vida de um aplicativo e não quiser reinstalar a janela sempre que for exibida, poderá manipular o Closing evento, cancelá-lo e chamar o Hide método . Em seguida, você pode chamar Show na mesma instância para reabri-la.