dialogBoxParamA 函数 (winuser.h)

项目
03/09/2024

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

语法

INT_PTR DialogBoxParamA(
  [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 参数中的对话框的值。

返回值

类型： INT_PTR

如果函数成功，则返回值为调用用于终止对话框的 EndDialog 函数中指定的 nResult 参数的值。

如果函数因 hWndParent 参数无效而失败，则返回值为零。在这种情况下，函数返回零，以便与以前版本的 Windows 兼容。如果函数因任何其他原因而失败，则返回值为 –1。要获得更多的错误信息，请调用 GetLastError。

注解

DialogBoxParam 函数使用 CreateWindowEx 函数创建对话框。然后，如果模板指定对话框过程的DS_SETFONT 或 DS_SHELLFONT样式) ，则 DialogBoxParam 将发送WM_INITDIALOG消息 (和WM_SETFONT消息。无论模板是否指定 WS_VISIBLE样式) 、禁用所有者窗口以及启动其自己的消息循环以检索和调度对话框的消息，函数都会显示对话框 (。

当对话框过程调用 EndDialog 函数时，DialogBoxParam 将销毁对话框，结束消息循环，启用所有者窗口 (（如果以前启用) ），并返回对话框过程在调用 EndDialog 时指定的 nResult 参数。

注意

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

要求

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