Window.ShowDialog Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Otevře okno a vrátí se pouze při zavření nově otevřeného okna.

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). Návratová hodnota je hodnota DialogResult vlastnosti před zavření okna.

Výjimky

InvalidOperationException

ShowDialog() je volána v okně, které je zavřené (Closing) nebo je 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 třída vytvořena instance, není ve výchozím nastavení viditelná. ShowDialog zobrazí okno, zakáže všechna ostatní okna v aplikaci a vrátí se jenom 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 jsou otevírání souborů nebo tisk dokumentů. Dialogová okna běžně umožňují uživatelům přijmout nebo zrušit úkol, pro který se zobrazil před zavřeným dialogovým oknem. ShowDialog Nullable<T> Boolean vrátí hodnotu, která určuje, zda byla aktivita přijata nebo zrušena. Návratová hodnota je hodnota DialogResult vlastnosti před zavření okna. Další informace najdete na webu DialogResult.

Okno otevřené voláním ShowDialog metody nemá automaticky relaci s oknem, které ho otevřelo, konkrétně otevřené okno neví, které okno ho otevřelo. Tuto relaci lze vytvořit pomocí Owner vlastnosti a spravovat ji pomocí OwnedWindows vlastnosti. Chcete-li podporovat automatizaci uživatelského rozhraní (viz Přehled automatizace uživatelského rozhraní), Owner musí být nastavena pro okno otevřené voláním ShowDialog.

Když je zavřené modální okno WPF (okno otevřené voláním ShowDialog), aktivuje se dříve aktivované okno znovu. Pokud má modální okno WPF okno vlastníka (viz Owner), okno vlastníka se znovu neaktivuje, když je modální okno WPF zavřené, 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