createDialogParamA 函数 (winuser.h)

从对话框模板资源创建无模式对话框。 在显示对话框之前,该函数会将应用程序定义的值作为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

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

[in, optional] hWndParent

类型:HWND

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

[in, optional] lpDialogFunc

类型: DLGPROC

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

[in] dwInitParam

类型: LPARAM

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

返回值

类型:HWND

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

如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。

注解

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

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

注意

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

要求

   
最低受支持的客户端 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) 中引入

另请参阅

概念性

CreateDialog

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DestroyWindow

对话框

DialogProc

IsDialogMessage

MAKEINTRESOURCE

参考

ShowWindow

WM_INITDIALOG

WM_SETFONT