Window.Close Window.Close Window.Close Window.Close Method

Definition

Schließt ein Window manuell.Manually closes a Window.

public:
 void Close();
[System.Security.SecurityCritical]
public void Close ();
member this.Close : unit -> unit
Public Sub Close ()

Beispiele

Das folgende Beispiel zeigt, wie ein Datei | Beendigungs Menü behandelt wird Close, das explizit aufgerufen wird.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

Hinweise

Ein Window kann mit einem von mehreren bekannten und vom System bereitgestellten Mechanismen geschlossen werden, die sich in der Titelleiste befinden, einschließlich:A Window can be closed using one of several, well-known, system-provided mechanisms located in its title bar, including:

  • ALT + F4.ALT+F4.

  • Das System | Menü ist geschlossen.System menu | Close.

  • Schaltfläche Schließen .Close button.

Ein Window kann auch mit einem von mehreren bekannten Mechanismen innerhalb des Client Bereichs geschlossen werden, die von Entwicklern bereitgestellt werden, einschließlich:A Window can also be closed using one of several well-known mechanisms within the client area that are provided by developers, including:

  • Datei | Beenden Sie in einem Hauptfenster.File | Exit on a main window.

  • Datei | Schließen oder schließen Sie die Schaltfläche Schließen eines untergeordneten Fensters.File | Close or a Close button on a child window.

Hinweis

Die Schaltflächen OK und Abbrechen in einem Dialogfeld werden ebenfalls vom Entwickler bereitgestellt, obwohl DialogResultwahrscheinlich festgelegt wird, wodurch automatisch ein Fenster geschlossen wird ShowDialog, das durch Aufrufen von geöffnet wurde.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.

Diese Mechanismen erfordern, dass Sie explizit Close aufzurufen, um ein Fenster zu schließen.These mechanisms require you to explicitly call Close to close a window.

Hinweis

Wenn ein Fenster, das durch Aufrufen ShowDialogvon geöffnet wird, Button und mit IsCancel einer-Eigenschaft, die auf true festgelegt ist, automatisch geschlossen wird, wenn auf die Schaltfläche geklickt wird, oder ESC gedrückt wird.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. Wenn das Fenster Showmithilfe von geöffnet wurde, Close muss jedoch explizit aufgerufen werden, z. b Click . von einem Ereignis ButtonHandler für den.If the window was opened using Show, however, Close must be explicitly called, such as from Click event handler for the Button.

Das Schließen eines Fensters bewirkt Closing , dass das-Ereignis ausgelöst wird.Closing a window causes the Closing event to be raised. Wenn das Closing Ereignis nicht abgebrochen wird, geschieht Folgendes:If the Closing event isn't canceled, the following occurs:

Das Schließen Window eines bewirkt, dass alle Fenster, die es besitzt, geschlossen werden.Closing a Window causes any windows that it owns to be closed. Außerdem kann das Schließen Window einer dazu führen, dass eine Anwendung nicht mehr ausgeführt wird Application.ShutdownMode , je nachdem, wie die-Eigenschaft festgelegt wird.Furthermore, closing a Window may cause an application to stop running depending on how the Application.ShutdownMode property is set.

Hinweis

Diese Methode kann nicht aufgerufen werden, wenn ein Fenster in einem Browser gehostet wird.This method cannot be called when a window is hosted in a browser.

Sicherheit

UIPermission
für die Berechtigung zur Verwendung aller Windows-und Benutzereingabe Ereignisse ohne Einschränkung.for permission to use all windows and user input events without restriction. Zugehörige Enumeration:AllWindowsAssociated enumeration: AllWindows

Gilt für:

Siehe auch