Window.Close Метод

Определение

Вручную закрывает окно Window.Manually closes a Window.

public:
 void Close();
[System.Security.SecurityCritical]
public void Close ();
member this.Close : unit -> unit
Public Sub Close ()
Атрибуты

Примеры

В следующем примере показано, как обрабатываются меню выхода файла | для явного вызова Close.The following example shows a File | Exit menu being handled to explicitly call Close.

<MenuItem Name="fileExitMenuItem" Header="E_xit" Click="fileExitMenuItem_Click"></MenuItem>
void fileExitMenuItem_Click(object sender, RoutedEventArgs e)
{
    // Close this window
    this.Close();
}
Private Sub fileExitMenuItem_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Close this window
    Me.Close()
End Sub

Комментарии

Window можно закрыть с помощью одного из нескольких хорошо известных, предоставляемых системой механизмов, расположенных в его заголовке, в том числе:A Window can be closed using one of several, well-known, system-provided mechanisms located in its title bar, including:

  • ALT + F4.ALT+F4.

  • | Закрытьсистемное меню.System menu | Close.

  • Кнопка " Закрыть ".Close button.

Window также можно закрыть с помощью одного из нескольких хорошо известных механизмов в клиентской области, предоставляемых разработчиками, включая:A Window can also be closed using one of several well-known mechanisms within the client area that are provided by developers, including:

  • **** | Выход из файла в главном окне.File | Exit on a main window.

  • Кнопка " Закрыть " или " Закрыть " в дочернем окне. **** |File | Close or a Close button on a child window.

Примечание

Кнопки ОК и Отмена в диалоговом окне также предоставляются разработчиками, хотя, скорее всего, будет установлено DialogResult, которое автоматически закроет окно, открытое при вызове ShowDialog.OK and Cancel buttons on a dialog box are also developer-provided, although will likely set DialogResult, which automatically closes a window that was opened by calling ShowDialog.

Эти механизмы потребовали явного вызова Close для закрытия окна.These mechanisms require you to explicitly call Close to close a window.

Примечание

Если окно, открываемое путем вызова ShowDialog, и Button со свойством IsCancel, установленным в значение true, автоматически закроется при нажатии кнопки, или если нажать клавишу ESC.If a window, opened by calling ShowDialog, and with a Button with its IsCancel property set to true, will automatically close when the button is either clicked, or ESC is pressed. Если окно было открыто с помощью Show, то Close необходимо явно вызывать, например из обработчика событий Click для Button.If the window was opened using Show, however, Close must be explicitly called, such as from Click event handler for the Button.

Закрытие окна приводит к возникновению события Closing.Closing a window causes the Closing event to be raised. Если событие Closing не отменено, происходит следующее:If the Closing event isn't canceled, the following occurs:

  • Window удаляется из Application.Windows (если существует объект Application).The Window is removed from Application.Windows (if an Application object exists).

  • Window удаляется из владельца Window если связь владелец/принадлежность была установлена до отображения владельца Window и после открытия Window владельца.The Window is removed from the owner Window if the owner/owned relationship was established before the owned Window was shown and after the owner Window was opened.

  • Возникает событие Closed.The Closed event is raised.

  • Неуправляемые ресурсы, созданные Window, удаляются.Unmanaged resources created by the Window are disposed.

  • Если был вызван ShowDialog для отображения Window, ShowDialog возвращает.If ShowDialog was called to show the Window, ShowDialog returns.

Закрытие Window приводит к закрытию всех окон, которыми он владеет.Closing a Window causes any windows that it owns to be closed. Кроме того, закрытие Window может привести к прекращению работы приложения в зависимости от того, как задано свойство Application.ShutdownMode.Furthermore, closing a Window may cause an application to stop running depending on how the Application.ShutdownMode property is set.

Примечание

Этот метод не может быть вызван, если окно размещается в браузере.This method cannot be called when a window is hosted in a browser.

Безопасность

UIPermission
разрешение на использование всех окон и событий ввода данных пользователем без ограничений.for permission to use all windows and user input events without restriction. Связанное перечисление: AllWindowsAssociated enumeration: AllWindows

Применяется к

Дополнительно