Window.ShowDialog Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Otevře okno a vrátí ho, jenom když je nově otevřené okno zavřené.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

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

Public Function ShowDialog () As Nullable(Of Boolean)

Návraty

Nullable<Boolean>

Nullable<T> Hodnota typuBoolean, která určuje, jestli byla aktivita přijata (true) nebo zrušena (false). Vrácená hodnota je hodnota DialogResult vlastnosti před zavření okna.

Výjimky

InvalidOperationException

ShowDialog() se volá v okně, které se zavírá (Closing) nebo bylo zavřené (Closed).

Příklady

Následující ukázka ukazuje, jak otevřít modální 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()

Poznámky

Když je Window vytvořena instance třídy, není ve výchozím nastavení viditelná. ShowDialog zobrazí okno, zakáže všechna ostatní okna v aplikaci a vrátí pouze v případě, že je okno zavřené. Tento typ okna se označuje jako modální okno.

Modální okna se primárně používají jako dialogová okna. Dialogové okno je speciální typ okna, které aplikace používají k interakci s uživateli při plnění úkolů, jako je otevírání souborů nebo tisk dokumentů. Dialogová okna obvykle umožňují uživatelům přijmout nebo zrušit úlohu, pro kterou se zobrazili před zavření dialogového okna. ShowDialogNullable<T>Boolean vrátí hodnotu, která určuje, zda byla aktivita přijata nebo zrušena. Vrácená hodnota je hodnota DialogResult vlastnosti před zavření okna. Další informace naleznete v tématu DialogResult.

Okno, které je otevřeno voláním ShowDialog metody, nemá automaticky relaci s oknem, které ho otevřelo; konkrétně otevřené okno neví, které okno se otevřelo. Tuto relaci lze navázat pomocí Owner vlastnosti a spravovat pomocí vlastnosti OwnedWindows . Pokud chcete podporovat automatizaci uživatelského rozhraní (viz Přehled automatizace uživatelského rozhraní), Owner musí být nastavená pro okno otevřené voláním ShowDialog.

Při zavření modálního okna WPF (okno otevřené voláním ShowDialog) se dříve aktivované okno znovu aktivuje. Pokud má modální okno WPF okno vlastníka (viz Owner), okno vlastníka se při zavření modálního okna WPF znovu neaktivuje, pokud se nejedná o dříve aktivované okno.

Poznámka

Tuto metodu nelze volat, pokud je okno hostované v prohlížeči.

Viz také

• Close()
• WindowState