CreateDialogIndirectParamA 関数 (winuser.h)

[アーティクル]
08/27/2023

メモリ内のダイアログボックステンプレートからモードレスダイアログボックスを作成します。この関数は、ダイアログボックスを表示する前に、WM_INITDIALOG メッセージの lParam パラメーターとして、アプリケーション定義の値をダイアログボックスプロシージャに渡します。アプリケーションでは、この値を使用してダイアログボックスコントロールを初期化できます。

構文

HWND CreateDialogIndirectParamA(
  [in, optional] HINSTANCE       hInstance,
  [in]           LPCDLGTEMPLATEA lpTemplate,
  [in, optional] HWND            hWndParent,
  [in, optional] DLGPROC         lpDialogFunc,
  [in]           LPARAM          dwInitParam
);

パラメーター

[in, optional] hInstance

種類: HINSTANCE

ダイアログボックステンプレートを含むモジュールへのハンドル。このパラメーターが NULL の場合は、現在の実行可能ファイルが使用されます。

[in] lpTemplate

種類: LPCDLGTEMPLATE

CreateDialogIndirectParam を使用してダイアログボックスを作成するテンプレート。ダイアログボックステンプレートは、ダイアログボックスを記述するヘッダーの後に、ダイアログボックス内の各コントロールを記述する 1 つ以上の追加のデータブロックで構成されます。テンプレートでは、標準形式または拡張形式のいずれかを使用できます。

標準テンプレートでは、ヘッダーは DLGTEMPLATE 構造体の後に追加の可変長配列が続きます。各コントロールのデータは、 DLGITEMTEMPLATE 構造体の後に追加の可変長配列が続きます。

拡張ダイアログボックステンプレートでは、ヘッダーは DLGTEMPLATEEX 形式を使用し、コントロール定義では DLGITEMTEMPLATEEX 形式を使用します。

CreateDialogIndirectParam が返された後は、ダイアログボックスの開始にのみ使用されるテンプレートを解放できます。

[in, optional] hWndParent

型: HWND

ダイアログボックスを所有するウィンドウへのハンドル。

[in, optional] lpDialogFunc

型: DLGPROC

ダイアログボックスプロシージャへのポインター。ダイアログボックスプロシージャの詳細については、DialogProc に関するページをご覧ください。

[in] dwInitParam

型: LPARAM

WM_INITDIALOG メッセージの lParam パラメーターのダイアログボックスに渡す値。

戻り値

型: HWND

関数が成功した場合、戻り値はダイアログボックスへのウィンドウハンドルです。

関数が失敗した場合は、返される値は NULL です。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

CreateDialogIndirectParam 関数は、CreateWindowEx 関数を使用してダイアログボックスを作成します。 CreateDialogIndirectParam は、ダイアログボックスプロシージャにWM_INITDIALOG メッセージを送信します。テンプレートで DS_SETFONTまたはDS_SHELLFONT スタイルが指定されている場合、関数はダイアログボックスプロシージャに WM_SETFONT メッセージも送信します。テンプレートで WS_VISIBLE スタイルが指定されている場合、この関数はダイアログボックスを表示します。最後に、 CreateDialogIndirectParam はウィンドウハンドルをダイアログボックスに返します。

CreateDialogIndirectParam が返された後、ShowWindow 関数を使用してダイアログボックスを表示できます (まだ表示されていない場合)。ダイアログボックスを破棄するには、 DestroyWindow 関数を使用します。キーボードナビゲーションやその他のダイアログボックス機能をサポートするには、ダイアログボックスのメッセージループで IsDialogMessage 関数を呼び出す必要があります。

標準ダイアログボックステンプレートでは、 DLGTEMPLATE 構造体と各 DLGITEMTEMPLATE 構造体を DWORD 境界に配置する必要があります。 DLGITEMTEMPLATE 構造体の後に続く作成データ配列も、DWORD 境界に配置する必要があります。テンプレート内の他のすべての可変長配列は、 WORD の境界に配置する必要があります。

拡張ダイアログボックステンプレートでは、 DLGTEMPLATEEX ヘッダーと各 DLGITEMTEMPLATEEX コントロール定義を DWORD 境界に配置する必要があります。 DLGITEMTEMPLATEEX 構造体に続く作成データ配列がある場合は、DWORD 境界にも配置する必要があります。テンプレート内の他のすべての可変長配列は、 WORD の境界に配置する必要があります。

ダイアログボックステンプレート内のすべての文字列 (ダイアログボックスのタイトルやボタンなど) は、Unicode 文字列である必要があります。

注意

winuser.h ヘッダーは、CreateDialogIndirectParam をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-dialogbox-l1-1-0 (Windows 8 で導入)

次の方法で共有

CreateDialogIndirectParamA 関数 (winuser.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース