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 folgende 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, es ist nicht standardmäßig angezeigt.When a Window class is instantiated, it is not visible by default. ShowDialog Zeigt das Fenster deaktiviert alle anderen Fenster in der Anwendung und gibt nur, wenn das Fenster geschlossen wird.ShowDialog shows the window, disables all other windows in the application, and returns only when the window is closed. Diese Art von Fenster wird als bezeichnet ein modale Fenster.This type of window is known as a modal window.

Modale Fenster werden in erster Linie als Dialogfelder verwendet werden.Modal windows are primarily used as dialog boxes. Ein Dialogfeld, das ist eine besondere Art von Fenster, die Anwendungen, die für die Interaktion mit Benutzern die Ausführung von Aufgaben wie das Öffnen von Dateien oder Drucken von Dokumenten verwenden.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. Dialogfelder ermöglichen im Allgemeinen Benutzer zum annehmen oder Abbrechen der Aufgabe, die für die sie angezeigt wurden, bevor Sie 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. ShowDialog Gibt eine Nullable<T> Boolean Wert, der angibt, ob die Aktivität bestätigt 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 geöffnet wird die ShowDialog Methode muss nicht automatisch eine Beziehung mit dem Fenster, die es geöffnet; insbesondere das geöffnete Fenster weiß nicht, welches Fenster, die sie geöffnet.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 hergestellt werden, mithilfe der Owner -Eigenschaft und Verwenden von verwalteten der OwnedWindows Eigenschaft.This relationship can be established using the Owner property and managed using the OwnedWindows property. Zur Unterstützung UIUI Automation (finden Sie unter UI Automation Overview), Owner muss festgelegt werden, für ein Fenster durch Aufrufen von ShowDialog.To support UIUI automation (see UI Automation Overview), Owner must be set for a window opened by calling ShowDialog.

Wenn eine modale WPFWPF Fenster (ein Fenster geöffnet wird, durch den Aufruf ShowDialog) geschlossen ist, 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 verfügt über eine besitzende Fenster (finden Sie unter Owner), das besitzende Fenster ist nicht erneut aktiviert, wenn der modale WPFWPF Fenster wird geschlossen, es sei denn, das zuvor aktivierte Fenster war.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 werden nicht aufgerufen, 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, um ein Fenster zu aktivieren.for permission to activate a window. Zugeordnete Enumeration: AllWindowsAssociated enumeration: AllWindows

Gilt für:

Siehe auch