CreateDialogParam函数从对话框模板资源创建无模式对话框。在显示对话框之前,该函数将应用程序定义的值传递给对话框过程作为WM_INITDIALOG消息的【lParam的】参数。应用程序可以使用此值初始化对话框控件。
HWND CreateDialogParam(
HINSTANCE 【的hInstance】, | //处理应用程序实例 |
LPCTSTR 【lpTemplateName】, | //标识对话框模板 |
HWND 【hWndParent】, | //处理所有者窗口 |
DLGPROC 【lpDialogFunc】, | //指向对话框的过程 |
LPARAM 【dwInitParam】 | //初始化值 |
); |
参数
【的hInstance】
标识可执行文件包含对话框模板的模块实例。
【lpTemplateName】
标识对话框模板。该参数是指向空值终止的字符串的指针,该字符串指定对话框模板的名称或指定对话框模板的资源标识符的整数值。如果参数指定资源标识符,则其高位字必须为零,低位字必须包含标识符。您可以使用MAKEINTRESOURCE宏创建此值。
【hWndParent】
标识拥有该对话框的窗口。
【lpDialogFunc】
指向对话框的过程。有关对话框过程的详细信息,请参阅DialogProc.
【dwInitParam】
指定要传递到WM_INITDIALOG消息中【lParam的】参数中的对话框过程的值。
返回值
如果函数成功,则返回值是对话框的窗口句柄。
如果函数失败,返回值为NULL。
备注
CreateDialogParam功能使用CreateWindowEx功能创建对话框。CreateDialogParam然后发送一个WM_INITDIALOG消息(和一个WM_SETFONT消息,如果模板指定DS_SETFONT样式)到对话框过程。如果模板指定了WS_VISIBLE样式,该函数将显示该对话框。最后,CreateDialogParam返回对话框的窗口句柄。
返回CreateDialogParam之后,应用程序将使用ShowWindow功能显示该对话框(如果尚未显示)。应用程序使用DestroyWindow功能来销毁该对话框。
Windows 95:系统最多支持16,364个窗口句柄。
也可以看看
CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DestroyWindow, DialogProc, MAKEINTRESOURCE, ShowWindow, WM_INITDIALOG, WM_SETFONT