Window.ShowDialog Window.ShowDialog Window.ShowDialog Window.ShowDialog Method

Definition

Öffnet ein Fenster und wird erst beendet, wenn das neu geöffnete Fenster geschlossen wird.Opens a window and returns only when the newly opened window is closed.

public:
 Nullable<bool> ShowDialog();
[System.Security.SecurityCritical]
public Nullable<bool> ShowDialog ();
member this.ShowDialog : unit -> Nullable<bool>
Public Function ShowDialog () As Nullable(Of Boolean)

Gibt zurück

Ein Nullable<T>-Wert vom Typ Boolean gibt an, ob die Aktivität bestätigt (true) oder abgebrochen (false) wurde.A Nullable<T> value of type Boolean that specifies whether the activity was accepted (true) or canceled (false). Der Rückgabewert ist der Wert der DialogResult-Eigenschaft, bevor ein Fenster geschlossen wird.The return value is the value of the DialogResult property before a window closes.

Ausnahmen

ShowDialog() wird für ein Fenster aufgerufen, das geschlossen wird (Closing) oder geschlossen wurde (Closed).ShowDialog() is called on a window that is closing (Closing) or has been closed (Closed).

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein modales Fenster geöffnet wird.The following sample demonstrates how to open a modal window.

// Instantiate window
DialogBox dialogBox = new DialogBox();

// Show window modally
// NOTE: Returns only when window is closed
Nullable<bool> dialogResult = dialogBox.ShowDialog();
' Instantiate window
Dim dialogBox As New DialogBox()

' Show window modally
' NOTE: Returns only when window is closed
Dim dialogResult? As Boolean = dialogBox.ShowDialog()

Hinweise

Wenn eine Window Klasse instanziiert wird, ist Sie standardmäßig nicht sichtbar.When a Window class is instantiated, it is not visible by default. ShowDialogzeigt das Fenster an, deaktiviert alle anderen Fenster in der Anwendung und gibt nur dann zurück, wenn das Fenster geschlossen wird.ShowDialog shows the window, disables all other windows in the application, and returns only when the window is closed. Dieser Fenstertyp wird als modales Fenster bezeichnet.This type of window is known as a modal window.

Modale Fenster werden hauptsächlich als Dialogfelder verwendet.Modal windows are primarily used as dialog boxes. Ein Dialogfeld ist ein spezieller Fenstertyp, der von Anwendungen zum interagieren mit Benutzern verwendet wird, um Aufgaben auszuführen, z. b. das Öffnen von Dateien oder das Drucken von Dokumenten.A dialog box is a special type of window that applications use to interact with users to complete tasks, such as opening files or printing documents. In Dialog Feldern können Benutzer die Aufgabe, für die Sie angezeigt wurden, annehmen oder Abbrechen, bevor das Dialogfeld geschlossen wird.Dialog boxes commonly allow users to accept or cancel the task for which they were shown before the dialog box is closed. ShowDialogGibt einen Nullable<T> Boolean Wert zurück, der angibt, ob die Aktivität akzeptiert oder abgebrochen wurde.ShowDialog returns a Nullable<T>Boolean value that specifies whether the activity was accepted or canceled. Der Rückgabewert ist der Wert der DialogResult-Eigenschaft, bevor ein Fenster geschlossen wird.The return value is the value of the DialogResult property before a window closes. Weitere Informationen finden Sie unter DialogResult.For more information, see DialogResult.

Ein Fenster, das durch den Aufruf der ShowDialog -Methode geöffnet wird, verfügt nicht automatisch über eine Beziehung mit dem Fenster, das es geöffnet hat. insbesondere weiß das geöffnete Fenster nicht, welches Fenster es geöffnet hat.A window that is opened by calling the ShowDialog method does not automatically have a relationship with the window that opened it; specifically, the opened window does not know which window opened it. Diese Beziehung kann mithilfe der Owner -Eigenschaft hergestellt und mithilfe der OwnedWindows -Eigenschaft verwaltet werden.This relationship can be established using the Owner property and managed using the OwnedWindows property. Zur unter UIUI Stützung der Automatisierung (siehe Übersicht überdie Owner Benutzeroberflächen Automatisierung) muss für ein Fenster fest ShowDialoggelegt werden, das durch Aufrufen von geöffnet wirdTo support UIUI automation (see UI Automation Overview), Owner must be set for a window opened by calling ShowDialog.

Wenn ein modales WPFWPF Fenster (ein Fenster, das ShowDialogdurch Aufrufen von geöffnet wird) geschlossen wird, wird das zuvor aktivierte Fenster erneut aktiviert.When a modal WPFWPF window (a window opened by calling ShowDialog) is closed, the previously activated window is reactivated. Wenn ein modales WPFWPF Fenster ein Besitzer Fenster hat ( Ownersiehe), wird das Besitzer Fenster nicht erneut aktiviert, wenn WPFWPF das modale Fenster geschlossen wird, es sei denn, es handelt sich um das zuvor aktivierte Fenster.If a modal WPFWPF window has an owner window (see Owner), the owner window is not reactivated when the modal WPFWPF window is closed unless it was the previously activated window.

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 zum Aktivieren eines Fensters.for permission to activate a window. Zugehörige Enumeration:AllWindowsAssociated enumeration: AllWindows

Gilt für:

Siehe auch