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