DialogBoxA 宏 (winuser.h)
从对话框模板资源创建模式对话框。 DialogBox 在指定的回调函数通过 调用 endDialog 函数终止模式对话框之前,不会返回控件。
DialogBox 作为对 DialogBoxParam 函数的调用来实现。
语法
void DialogBoxA(
[in, optional] hInstance,
[in] lpTemplate,
[in, optional] hWndParent,
[in, optional] lpDialogFunc
);
参数
[in, optional] hInstance
类型:HINSTANCE
包含对话框模板的模块句柄。 如果此参数为 NULL,则使用当前可执行文件。
[in] lpTemplate
类型:LPCTSTR
对话框模板。 此参数是指向以 null 结尾的字符串的指针,该字符串指定对话框模板的名称或指定对话框模板的资源标识符的整数值。 如果参数指定资源标识符,则其高序单词必须为零,其低序单词必须包含标识符。 可以使用 MAKEINTRESOURCE 宏创建此值。
[in, optional] hWndParent
类型:HWND
拥有对话框的窗口的句柄。
[in, optional] lpDialogFunc
类型:DLGPROC
指向对话框过程的指针。 有关对话框过程的详细信息,请参阅 DialogProc。
返回值
没有
言论
DialogBox 宏使用 CreateWindowEx 函数创建对话框。 DialogBox 然后向对话框过程发送 WM_INITDIALOG 消息(如果模板指定 DS_SETFONT 或DS_SHELLFONT样式),则会发送 WM_SETFONT 消息。 该函数显示对话框(无论模板是否指定 WS_VISIBLE 样式),禁用所有者窗口,并启动其自己的消息循环来检索和调度对话框的消息。
当对话框过程调用
例子
有关示例,请参阅 创建模式对话框。
注意
winuser.h 标头将 DialogBox 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | 窗户 |
标头 | winuser.h (包括 Windows.h) |
库 | User32.lib |
DLL | User32.dll |
另请参阅
概念
参考