DialogBoxParamW

ダイアログボックステンプレートリソースからモーダルダイアログボックスを作成する。(Unicode)

DialogBoxParamW hInstance, lpTemplateName, hWndParent, lpDialogFunc, dwInitParam

hInstance : [intptr] 型: HINSTANCE ダイアログボックステンプレートを含むモジュールへのハンドル。このパラメータが NULL の場合、現在の実行可能ファイルが使用される。
lpTemplateName : [wstr] 型: LPCTSTR ダイアログボックステンプレート。このパラメータは、ダイアログボックステンプレートの名前を指定する NULL 終端文字列へのポインタか、ダイアログボックステンプレートのリソース識別子を指定する整数値のいずれかである。リソース識別子を指定する場合、上位ワードは 0、下位ワードに識別子を含めなければならない。この値の作成には MAKEINTRESOURCE マクロを使用できる。
hWndParent : [intptr] 型: HWND ダイアログボックスを所有するウィンドウへのハンドル。
lpDialogFunc : [int] 型: DLGPROC ダイアログボックスプロシージャへのポインタ。詳細は DialogProc を参照。
dwInitParam : [intptr] 型: LPARAM WM_INITDIALOG メッセージの lParam パラメータでダイアログボックスに渡す値。

(プラグイン / モジュール : user32.dll)

解説

ダイアログボックステンプレートリソースからモーダルダイアログボックスを作成する。(Unicode)

[戻り値]
型: INT_PTR 関数が成功した場合、戻り値はダイアログボックスを終了させた EndDialog 関数の呼び出しで指定された
nResult パラメータの値となる。hWndParent パラメータが無効なために関数が失敗した場合、戻り値は 0
となる。その他の理由で関数が失敗した場合、戻り値は -1 となる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
DialogBoxParam 関数は CreateWindowEx
関数を使用してダイアログボックスを作成する。その後、ダイアログボックスプロシージャに WM_INITDIALOG メッセージを送信する
(テンプレートが DS_SETFONT または DS_SHELLFONT スタイルを指定している場合は WM_SETFONT
メッセージも送信する)。関数はダイアログボックスを表示し、所有者ウィンドウを無効化し、ダイアログボックスのメッセージを取得およびディスパッチするための独自のメッセージループを開始する。ダイアログボックスプロシージャが
EndDialog 関数を呼び出すと、DialogBoxParam
はダイアログボックスを破棄し、メッセージループを終了し、所有者ウィンドウを有効化し、EndDialog で指定された nResult
パラメータを返す。

情報