Window.ShowDialog メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ウィンドウを開き、開いたウィンドウが閉じた場合にのみ制御を戻します。
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)
戻り値
アクティビティが受け入れられた (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 ウィンドウが閉じられると、所有者ウィンドウは再アクティブ化されません。
注意
ウィンドウがブラウザーでホストされている場合、このメソッドを呼び出すことはできません。