Window.ShowDialog Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Otwiera okno i zwraca wartość tylko wtedy, gdy nowo otwarte okno jest zamknięte.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

member this.ShowDialog : unit -> Nullable<bool>

Public Function ShowDialog () As Nullable(Of Boolean)

Zwraca

Nullable<Boolean>

Nullable<T> Wartość typu Boolean określająca, czy działanie zostało zaakceptowane (true) lub anulowane (false). Wartość zwracana jest wartością DialogResult właściwości przed zamknięciem okna.

Wyjątki

InvalidOperationException

ShowDialog() jest wywoływany w oknie zamykającym (Closing) lub został zamknięty (Closed).

Przykłady

W poniższym przykładzie pokazano, jak otworzyć modalne okno.

// 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()

Uwagi

Po utworzeniu Window wystąpienia klasy domyślnie nie jest ona widoczna. ShowDialog pokazuje okno, wyłącza wszystkie inne okna w aplikacji i zwraca tylko wtedy, gdy okno jest zamknięte. Ten typ okna jest nazywany modalnym oknem.

Modalne okna są używane głównie jako okna dialogowe. Okno dialogowe to specjalny typ okna, którego aplikacje używają do interakcji z użytkownikami w celu wykonywania zadań, takich jak otwieranie plików lub drukowanie dokumentów. Okna dialogowe często umożliwiają użytkownikom akceptowanie lub anulowanie zadania, dla którego były wyświetlane przed zamknięciem okna dialogowego. ShowDialog zwraca wartość określającą Nullable<T>Boolean , czy działanie zostało zaakceptowane, czy anulowane. Wartość zwracana jest wartością DialogResult właściwości przed zamknięciem okna. Aby uzyskać więcej informacji, zobacz DialogResult.

Okno otwarte przez wywołanie ShowDialog metody nie ma automatycznie relacji z otwartym oknem. W szczególności otwarte okno nie wie, które zostało otwarte. Tę relację można ustanowić przy użyciu Owner właściwości i zarządzanej OwnedWindows za pomocą właściwości . Aby obsługiwać automatyzację interfejsu użytkownika (zobacz automatyzacja interfejsu użytkownika Przegląd), Owner należy ustawić okno otwarte przez wywołanie polecenia ShowDialog.

Gdy modalne okno WPF (okno otwarte przez wywołanie ShowDialog) jest zamknięte, aktywowane wcześniej okno zostanie ponownie aktywowane. Jeśli modalne okno WPF ma okno właściciela (zobacz Owner), okno właściciela nie jest ponownie aktywowane, gdy modalne okno WPF jest zamknięte, chyba że zostało wcześniej aktywowane okno.

Uwaga

Nie można wywołać tej metody, gdy okno jest hostowane w przeglądarce.

Zobacz też

• Close()
• WindowState