Window.ShowDialog Methode

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

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

Attribute

SecurityCriticalAttribute

Ausnahmen

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 dann zurück, wenn das Fenster geschlossen wird. Dieser Fenstertyp wird als modales Fenster bezeichnet.

Modale Fenster werden in erster Linie als Dialogfelder verwendet. Ein Dialogfeld ist ein spezieller Fenstertyp, mit dem Anwendungen mit Benutzern interagieren, um Aufgaben auszuführen, z. B. das Öffnen von Dateien oder das Drucken von Dokumenten. In Dialogfeldern können Benutzer häufig die Aufgabe annehmen oder abbrechen, 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 mithilfe der OwnedWindows Eigenschaft verwaltet werden. Um die Benutzeroberflächenautomatisierung zu unterstützen (siehe Übersicht über die Benutzeroberflächenautomatisierung), Owner muss für ein durch Aufrufen ShowDialoggeöffnetes Fenster festgelegt werden.

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 war das zuvor aktivierte Fenster.

Weitere Informationen

• Close()
• WindowState