Window.Closing Event
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Occurs when the window is about to close.
Namespace: System.Windows
Assembly: System.Windows (in System.Windows.dll)
Syntax
'Declaration
Public Event Closing As EventHandler(Of ClosingEventArgs)
public event EventHandler<ClosingEventArgs> Closing
Exceptions
| Exception | Condition |
|---|---|
| NotSupportedException | When adding or removing an event handler, the application is not running outside the browser. |
Remarks
You can handle this event in order to prevent the window from closing. This is useful to perform actions such as displaying a warning if the user has unsaved changes in the application data. To cancel the event, set the Cancel property of the ClosingEventArgs object to true.
This event occurs when you call the Close method or when the user closes the window. It also occurs when the window closes for some other reason, such as system shutdown or user logoff. In these cases, however, you cannot cancel the event. To determine whether cancelation is possible, check the ClosingEventArgs.IsCancelable property.
Examples
The following code example demonstrates the use of this event. In this example, the current window position and dimensions are saved to the ApplicationSettings in the isolated storage as a user defined key/value pair. These values can be retrieved at application startup to set the window settings.
' Event handler for the Window.Closing event.
Private Sub MainWindow_Closing(ByVal sender As System.Object, ByVal e As System.ComponentModel.ClosingEventArgs)
If Application.Current.IsRunningOutOfBrowser Then
' Show a message when application shuts down and
' give the user a chance to cancel the operation.
If (MessageBox.Show(
"Are you sure you want to close this application.",
"Application Shutdown",
MessageBoxButton.OKCancel) = MessageBoxResult.OK) Then
' Get the main window.
Dim mainWindow As Window = Application.Current.MainWindow
' Call helper method to save the window settings.
SetApplicationSetting("WindowTop", mainWindow.Top.ToString)
SetApplicationSetting("WindowLeft", mainWindow.Left.ToString)
SetApplicationSetting("WindowWidth", mainWindow.Width.ToString)
SetApplicationSetting("WindowHeight", mainWindow.Height.ToString)
Else
' Cancel the appliation shutdown.
e.Cancel = True
End If
End If
End Sub
' Helper function to set an application setting.
Private Sub SetApplicationSetting(ByVal key As String, ByVal value As String)
' Get the Application Settings.
Dim appSettings As IsolatedStorageSettings = IsolatedStorageSettings.ApplicationSettings
' Save the window settings to IsolatedStorage.
Try
If Not appSettings.Contains(key) Then
IsolatedStorageSettings.ApplicationSettings.Add(key, value)
Else
appSettings(key) = value
End If
Catch ex As Exception
' Logic to handle exception.
End Try
End Sub
// Event handler for the Window.Closing event.
void MainWindow_Closing(object sender, System.ComponentModel.ClosingEventArgs e)
{
if (Application.Current.IsRunningOutOfBrowser)
{
// Show a message when application shuts down and
// and give the user a chance to cancel the operation.
if (MessageBox.Show(
"Are you sure you want to close this application.",
"Application Shutdown",
MessageBoxButton.OKCancel) == MessageBoxResult.OK)
{
// Get the main window.
Window mainWindow = Application.Current.MainWindow;
// Call helper method to save the window settings.
SetApplicationSetting("WindowTop", mainWindow.Top.ToString());
SetApplicationSetting("WindowLeft", mainWindow.Left.ToString());
SetApplicationSetting("WindowWidth", mainWindow.Width.ToString());
SetApplicationSetting("WindowHeight", mainWindow.Height.ToString());
}
else
{
// Cancel the appliation shutdown.
e.Cancel = true;
}
}
}
// Helper function to set an application setting.
private void SetApplicationSetting(string key, string value)
{
// Get the Application Settings.
IsolatedStorageSettings appSettings = IsolatedStorageSettings.ApplicationSettings;
// Save the window settings to IsolatedStorage.
try
{
if (!appSettings.Contains(key))
{
IsolatedStorageSettings.ApplicationSettings.Add(key, value);
}
else
{
appSettings[key] = value;
}
}
catch (KeyNotFoundException)
{
// Logic to handle exception.
}
}
By default, you cannot reuse a window after it is closed. To display and hide a window multiple times, you must set its Visibility property and cancel its Closing event, as shown in the following code example. This example requires a UserControl subclass named DemoUserControl. Additionally, this example will work only in a trusted, out-of-browser application targeting Silverlight 5.
Private Sub ShowHideDemoWindowButton_Click(
sender As System.Object, e As System.Windows.RoutedEventArgs)
If (Not Application.Current.IsRunningOutOfBrowser OrElse _
Not Application.Current.HasElevatedPermissions) Then Return
DemoWindow.Visibility = If(DemoWindow.IsVisible,
Visibility.Collapsed, Visibility.Visible)
End Sub
Private _demoWindow As Window
Private ReadOnly Property DemoWindow As Window
Get
If (Not Application.Current.IsRunningOutOfBrowser OrElse
Not Application.Current.HasElevatedPermissions) Then Return Nothing
If _demoWindow Is Nothing Then
_demoWindow = New Window With
{
.Title = "Demo Window",
.Content = New DemoUserControl(),
.Height = 300, .Width = 300, .Top = 0, .Left = 0
}
AddHandler _demoWindow.Closing,
Sub(sender As Object,
e As System.ComponentModel.ClosingEventArgs)
If (e.IsCancelable) Then
e.Cancel = True
_demoWindow.Visibility = Visibility.Collapsed
End If
End Sub
End If
Return _demoWindow
End Get
End Property
private void ShowHideDemoWindowButton_Click(object sender, RoutedEventArgs e)
{
if (!Application.Current.IsRunningOutOfBrowser ||
!Application.Current.HasElevatedPermissions) return;
DemoWindow.Visibility = DemoWindow.IsVisible ?
Visibility.Collapsed : Visibility.Visible;
}
private Window _demoWindow;
private Window DemoWindow
{
get
{
if (!Application.Current.IsRunningOutOfBrowser ||
!Application.Current.HasElevatedPermissions) return null;
if (_demoWindow == null)
{
_demoWindow = new Window()
{
Title = "Demo Window",
Content = new DemoUserControl(),
Height = 300, Width = 300, Top = 0, Left = 0
};
_demoWindow.Closing += (sender, e) =>
{
if (e.IsCancelable)
{
e.Cancel = true;
_demoWindow.Visibility = Visibility.Collapsed;
}
};
}
return _demoWindow;
}
}
Version Information
Silverlight
Supported in: 5, 4
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also