Freigeben über

Window.ShowDialog Methode

  • Referenz

Definition

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Öffnet ein Fenster und wird erst beendet, wenn das neu geöffnete Fenster geschlossen wird.

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

Gibt zurück

Nullable<Boolean>

Ein Nullable<T>-Wert vom Typ Boolean gibt an, ob die Aktivität bestätigt (true) oder abgebrochen (false) wurde. Der Rückgabewert ist der Wert der DialogResult-Eigenschaft, bevor ein Fenster geschlossen wird.

Attribute
SecurityCriticalAttribute

Ausnahmen

InvalidOperationException

ShowDialog() wird für ein Fenster aufgerufen, das geschlossen wird (Closing) oder geschlossen wurde (Closed).

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein modales Fenster geöffnet wird.

// 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. ShowDialog zeigt das Fenster an, deaktiviert alle anderen Fenster in der Anwendung und gibt nur zurück, wenn das Fenster geschlossen wird. Dieser Typ von Fenster wird als modales Fenster bezeichnet.

Modale Fenster werden hauptsächlich als Dialogfelder verwendet. Ein Dialogfeld ist ein spezieller Typ von Fenstern, mit dem Anwendungen mit Benutzern interagieren, um Aufgaben wie das Öffnen von Dateien oder das Drucken von Dokumenten auszuführen. Dialogfelder ermöglichen es Benutzern in der Regel, die Aufgabe zu akzeptieren oder abzubrechen, für die sie angezeigt wurden, bevor das Dialogfeld geschlossen wird. ShowDialog gibt einen Nullable<T>Boolean Wert zurück, der angibt, ob die Aktivität akzeptiert oder abgebrochen wurde. Der Rückgabewert ist der Wert der DialogResult-Eigenschaft, bevor ein Fenster geschlossen wird. Weitere Informationen finden Sie unter DialogResult.

Ein Fenster, das durch Aufrufen der ShowDialog -Methode geöffnet wird, verfügt nicht automatisch über eine Beziehung zu dem Fenster, das es geöffnet hat. Insbesondere weiß das geöffnete Fenster nicht, welches Fenster es geöffnet hat. Diese Beziehung kann mithilfe der Owner -Eigenschaft hergestellt und mit der OwnedWindows -Eigenschaft verwaltet werden. Zur Unterstützung der Benutzeroberflächenautomatisierung (siehe Übersicht über die Benutzeroberflächenautomatisierung) Owner muss für ein Fenster festgelegt werden, das durch Aufrufen ShowDialogvon geöffnet wird.

Wenn ein modales WPF-Fenster (ein Durch Aufrufen ShowDialoggeöffnetes Fenster) geschlossen wird, wird das zuvor aktivierte Fenster reaktiviert. Wenn ein modales WPF-Fenster über ein Besitzerfenster verfügt (siehe Owner), wird das Besitzerfenster nicht reaktiviert, wenn das modale WPF-Fenster geschlossen wird, es sei denn, es handelt sich um das zuvor aktivierte Fenster.

Hinweis

Diese Methode kann nicht aufgerufen werden, wenn ein Fenster in einem Browser gehostet wird.

Gilt für:

Weitere Informationen