Window.ShowDialog Window.ShowDialog Window.ShowDialog Window.ShowDialog Method

定義

ウィンドウを開き、開いたウィンドウが閉じた場合にのみ制御を戻します。Opens a window and returns only when the newly opened window is closed.

public:
 Nullable<bool> ShowDialog();
[System.Security.SecurityCritical]
public Nullable<bool> ShowDialog ();
member this.ShowDialog : unit -> Nullable<bool>
Public Function ShowDialog () As Nullable(Of Boolean)

戻り値

アクティビティが受け入れられた (true) か、取り消された (false) かを示す Nullable<T> 型の Boolean 値。A Nullable<T> value of type Boolean that specifies whether the activity was accepted (true) or canceled (false). この戻り値は、ウィンドウが閉じる前の DialogResult プロパティの値です。The return value is the value of the DialogResult property before a window closes.

例外

閉じている途中 (ShowDialog()) または閉じた (Closing) ウィンドウに対して Closed が呼び出されている。ShowDialog() is called on a window that is closing (Closing) or has been closed (Closed).

モーダルウィンドウを開く方法を次の例に示します。The following sample demonstrates how to open a modal window.

// 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クラスがインスタンス化されると、既定では表示されません。When a Window class is instantiated, it is not visible by default. ShowDialogウィンドウを表示し、アプリケーション内の他のウィンドウをすべて無効にして、ウィンドウが閉じている場合にのみを返します。ShowDialog shows the window, disables all other windows in the application, and returns only when the window is closed. この種類のウィンドウをモーダルウィンドウと呼びます。This type of window is known as a modal window.

モーダルウィンドウは、主にダイアログボックスとして使用されます。Modal windows are primarily used as dialog boxes. ダイアログボックスは、アプリケーションがユーザーとやり取りして、ファイルのオープンやドキュメントの印刷などのタスクを実行するために使用する、特別な種類のウィンドウです。A dialog box is a special type of window that applications use to interact with users to complete tasks, such as opening files or printing documents. ダイアログボックスを使用すると、通常、ダイアログボックスが閉じられる前に表示されていたタスクをユーザーが受け入れたり取り消したりできます。Dialog boxes commonly allow users to accept or cancel the task for which they were shown before the dialog box is closed. ShowDialogアクティビティが受け入れられたか取り消されたかを示す値を返します。Boolean Nullable<T>ShowDialog returns a Nullable<T>Boolean value that specifies whether the activity was accepted or canceled. この戻り値は、ウィンドウが閉じる前の DialogResult プロパティの値です。The return value is the value of the DialogResult property before a window closes. 詳細については、「DialogResult」を参照してください。For more information, see DialogResult.

ShowDialogメソッドを呼び出すことによって開かれたウィンドウには、そのウィンドウを開いたウィンドウとの関係は自動的にはありません。つまり、開いているウィンドウでは、どのウィンドウが開いているかがわかりません。A window that is opened by calling the ShowDialog method does not automatically have a relationship with the window that opened it; specifically, the opened window does not know which window opened it. このリレーションシップは、 Ownerプロパティを使用して確立し、 OwnedWindowsプロパティを使用して管理できます。This relationship can be established using the Owner property and managed using the OwnedWindows property. オートメーションをUIUIサポートするには (「 UI オートメーションの概要」を参照)、をOwner呼び出しShowDialogて開いたウィンドウに対してを設定する必要があります。To support UIUI automation (see UI Automation Overview), Owner must be set for a window opened by calling ShowDialog.

モーダルWPFWPFウィンドウ (を呼び出しShowDialogて開いたウィンドウ) を閉じると、アクティブになっていたウィンドウが再アクティブ化されます。When a modal WPFWPF window (a window opened by calling ShowDialog) is closed, the previously activated window is reactivated. モーダルWPFWPFウィンドウにオーナーウィンドウがある場合 (「 Owner」を参照)、モーダルWPFWPFウィンドウが閉じているときに、前にアクティブ化されたウィンドウでない限り、オーナーウィンドウは再アクティブ化されません。If a modal WPFWPF window has an owner window (see Owner), the owner window is not reactivated when the modal WPFWPF window is closed unless it was the previously activated window.

注意

ウィンドウがブラウザーでホストされている場合、このメソッドを呼び出すことはできません。This method cannot be called when a window is hosted in a browser.

セキュリティ

UIPermission
ウィンドウをアクティブにするアクセス許可の場合は。for permission to activate a window. 関連付けられた列挙型:AllWindowsAssociated enumeration: AllWindows

適用対象

こちらもご覧ください