DialogBoxParam函数从对话框模板资源创建一个模态对话框。在显示对话框之前,该函数将应用程序定义的值传递给对话框过程作为WM_INITDIALOG消息的【lParam的】参数。应用程序可以使用此值初始化对话框控件。
int DialogBoxParam(
HINSTANCE 【的hInstance】, | //处理应用程序实例 |
LPCTSTR 【lpTemplateName】, | //标识对话框模板 |
HWND 【hWndParent】, | //处理所有者窗口 |
DLGPROC 【lpDialogFunc】, | //指向对话框的过程 |
LPARAM 【dwInitParam】 | //初始化值 |
); |
参数
【的hInstance】
标识可执行文件包含对话框模板的模块实例。
【lpTemplateName】
标识对话框模板。该参数是指向空值终止的字符串的指针,该字符串指定对话框模板的名称或指定对话框模板的资源标识符的整数值。如果参数指定资源标识符,其高位字必须为零,低位字必须包含标识符。您可以使用MAKEINTRESOURCE宏创建此值。
【hWndParent】
标识拥有该对话框的窗口。
【lpDialogFunc】
指向对话框的过程。有关对话框过程的更多信息,请参阅DialogProc回调函数。
【dwInitParam】
指定要传递到WM_INITDIALOG消息的【lParam的】参数中的对话框的值。
返回值
如果函数成功,则返回值是用于终止对话框的EndDialog函数调用中指定的【如果函数失败,返回值为-1。】参数的值。
如果函数失败,返回值为-1。
备注
DialogBoxParam功能使用CreateWindowEx功能创建对话框。DialogBoxParam然后发送一个WM_INITDIALOG消息(和一个WM_SETFONT消息,如果模板指定DS_SETFONT样式)到对话框过程。该函数显示对话框(无论模板是否指定WS_VISIBLE样式),禁用所有者窗口,并启动自己的消息循环来检索和调度对话框的消息。
当对话框过程调用EndDialog功能时,DialogBoxParam破坏对话框,结束消息循环,启用所有者窗口(如果先前已启用),并返回对话框过程指定的【如果函数失败,返回值为-1。】参数称为EndDialog.
Windows 95:系统最多可以支持16,364个窗口句柄。
也可以看看
CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT