War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
ShowDialog-Methode
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Window.ShowDialog-Methode

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

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public Nullable<bool> ShowDialog()

Rückgabewert

Typ: System.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.

AusnahmeBedingung
InvalidOperationException

ShowDialog wird für ein Window aufgerufen, das sichtbar ist

- oder -

ShowDialog wird für ein sichtbares Window aufgerufen, das durch Aufrufen von ShowDialog geöffnet wurde.

InvalidOperationException

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

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 wird erst beendet, wenn das Fenster geschlossen wurde. Dieser Typ von Fenster wird als modales Fenster bezeichnet.

Modale Fenster werden hauptsächlich als Dialogfelder verwendet. Ein Dialogfeld ist ein besonderer Typ von Fenster, der von Anwendungen für die Interaktion mit Benutzern zum Ausführen von Aufgaben verwendet wird, z. B. zum Öffnen von Dateien oder Drucken von Dokumenten. Dialogfelder ermöglichen es Benutzern im Allgemeinen, die Aufgabe zu akzeptieren oder abzubrechen, die vor dem Schließen des Dialogfeldes angezeigt wurde. ShowDialog gibt einen Nullable<T>Boolean-Wert zurück, der angibt, ob die Aktivität bestätigt oder abgebrochen wurde. Der Rückgabewert ist der Wert der DialogResult-Eigenschaft, bevor ein Fenster geschlossen wird. Weitere Informationen finden Sie unter DialogResult.

Ein durch Aufruf der ShowDialog-Methode geöffnetes Fenster weist nicht automatisch eine Beziehung zu dem Fenster auf, von dem es geöffnet wurde. Insbesondere liegen dem geöffneten Fenster keine Angaben darüber vor, von welchem Fenster es geöffnet wurde. Diese Beziehung kann über die Owner-Eigenschaft eingerichtet und über die OwnedWindows-Eigenschaft verwaltet werden. Zur Unterstützung der Benutzeroberfläche-Automatisierung (siehe Übersicht über die Benutzeroberflächenautomatisierung) muss Owner für ein durch Aufruf von ShowDialog geöffnetes Fenster festgelegt werden.

Wenn ein modales WPF-Fenster (ein Fenster, das durch Aufrufen von ShowDialog geöffnet wird) geschlossen wird, wird das zuvor aktivierte Fenster erneut aktiviert. Wenn ein modales Fenster WPF ein Besitzerfenster hat (siehe Owner), wird das Besitzerfenster nur dann beim Schließen des modalen WPF-Fensters erneut aktiviert, wenn es das zuvor aktivierte Fenster war.

HinweisHinweis

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

Das folgende Beispiel 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();


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft