Window.ShowDialog メソッド

定義

ウィンドウを開き、開いたウィンドウが閉じた場合にのみ制御を戻します。

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)

戻り値

Nullable<Boolean>

アクティビティが受け入れられた (true) か、取り消された (false) かを示す Nullable<T> 型の Boolean 値。 この戻り値は、ウィンドウが閉じる前の DialogResult プロパティの値です。

属性

例外

閉じている途中 (ShowDialog()) または閉じた (Closing) ウィンドウに対して Closed が呼び出されている。

次の例では、モーダル ウィンドウを開く方法を示します。

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

注釈

クラスが Window インスタンス化されると、既定では表示されません。 ShowDialog はウィンドウを表示し、アプリケーション内の他のすべてのウィンドウを無効にし、ウィンドウが閉じられたときにのみ を返します。 この種類のウィンドウは モーダル ウィンドウと 呼ばれます。

モーダル ウィンドウは、主にダイアログ ボックスとして使用されます。 ダイアログ ボックスは、ファイルの開き方やドキュメントの印刷などのタスクを完了するためにアプリケーションがユーザーと対話するために使用する特別な種類のウィンドウです。 ダイアログ ボックスを使用すると、ダイアログ ボックスを閉じる前に表示されたタスクをユーザーが受け入れるか取り消すことが一般的です。 ShowDialog は、 Nullable<T>Boolean アクティビティが受け入れられたか取り消されたかを示す値を返します。 この戻り値は、ウィンドウが閉じる前の DialogResult プロパティの値です。 詳細については、「DialogResult」を参照してください。

メソッドを呼び出 ShowDialog して開いたウィンドウは、開いたウィンドウとのリレーションシップを自動的に持つことはありません。具体的には、開いているウィンドウで開かれたウィンドウが認識されません。 このリレーションシップは、 プロパティを使用して確立し、 Owner プロパティを OwnedWindows 使用して管理できます。 UI オートメーションをサポートするには (「UI オートメーション概要」を参照) Owner を呼び出ShowDialogして開いたウィンドウに対して を設定する必要があります。

モーダル WPF ウィンドウ (を呼び出 ShowDialogして開いたウィンドウ) が閉じられると、以前にアクティブ化されたウィンドウが再アクティブ化されます。 モーダル WPF ウィンドウに所有者ウィンドウがある場合 (「」を参照) Owner、モーダル WPF ウィンドウが以前にアクティブ化されたウィンドウでない限り、モーダル WPF ウィンドウが閉じられると、所有者ウィンドウは再アクティブ化されません。

注意

ウィンドウがブラウザーでホストされている場合、このメソッドを呼び出すことはできません。

適用対象

こちらもご覧ください