CreateDialogParamA 函数（winuser.h）

项目
11/20/2024

从对话框模板资源创建无模式对话框。在显示对话框之前，该函数会将应用程序定义的值作为 WM_INITDIALOG 消息的 lParam 参数传递给对话框过程。应用程序可以使用此值初始化对话框控件。

语法

HWND CreateDialogParamA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpTemplateName,
  [in, optional] HWND      hWndParent,
  [in, optional] DLGPROC   lpDialogFunc,
  [in]           LPARAM    dwInitParam
);

参数

[in, optional] hInstance

类型：HINSTANCE

包含对话框模板的模块句柄。如果此参数为 NULL，则使用当前可执行文件。

[in] lpTemplateName

类型：LPCTSTR

对话框模板。此参数是指向以 null 结尾的字符串的指针，该字符串指定对话框模板的名称或指定对话框模板的资源标识符的整数值。如果参数指定资源标识符，则其高序单词必须为零，低序单词必须包含标识符。可以使用 MAKEINTRESOURCE 宏创建此值。

[in, optional] hWndParent

类型：HWND

拥有对话框的窗口的句柄。

[in, optional] lpDialogFunc

类型：DLGPROC

指向对话框过程的指针。有关对话框过程的详细信息，请参阅 DialogProc。

[in] dwInitParam

类型：LPARAM

要传递给 WM_INITDIALOG 消息中的 lParam 参数中的对话框过程的值。

返回值

类型：HWND

如果函数成功，则返回值为对话框的窗口句柄。

如果函数失败，则返回值 NULL。若要获取扩展的错误信息，请调用 GetLastError。

言论

CreateDialogParam 函数使用 CreateWindowEx 函数创建对话框。 CreateDialogParam 然后向对话框过程发送 WM_INITDIALOG 消息（如果模板指定 DS_SETFONT 或DS_SHELLFONT样式），则发送 WM_SETFONT 消息。如果模板指定 WS_VISIBLE 样式，该函数将显示对话框。最后，CreateDialogParam 返回对话框的窗口句柄。

CreateDialogParam 返回后，应用程序将使用 ShowWindow 函数显示对话框（如果尚未显示）。应用程序使用 DestroyWindow 函数销毁对话框。若要支持键盘导航和其他对话框功能，对话框的消息循环必须调用 IsDialogMessage 函数。

注意

winuser.h 标头将 CreateDialogParam 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	winuser.h （包括 Windows.h）
库	User32.lib
DLL	User32.dll
API 集	ext-ms-win-ntuser-dialogbox-l1-1-0（在 Windows 8 中引入）