CreateDialogParam

原文链接 -> 传送门

函数功能：

CreateDialogParam 函数从一个对话框模板资源创建一个非模态对话框。在显示对话框之前，函数把一个应用程序定义的值作为 WM_INITDIALOG 消息的 IParam 参数传到对话框。应用程序可用此值来初始化对话框控件。


API 函数原型：

注释：_In_ 说明该参数是输入的，_In_opt_ 说明该参数是输入同时是可选的。

HWND WINAPI CreateDialogParam(
  _In_opt_ HINSTANCE hInstance,
  _In_     LPCTSTR   lpTemplateName,
  _In_opt_ HWND      hWndParent,
  _In_opt_ DLGPROC   lpDialogFunc,
  _In_     LPARAM    dwInitParam
);

参数解析：
 

返回值：

1. 如果函数调用成功，则返回值为指向对话框的句柄；

2. 如果函数调用失败，则返回值为 NULL。若想获得更多的扩展错误信息，可调用 GetLastError 函数。


备注：

1. CreateDialogParam 函数用 CreateWindowEx 函数来创建对话框。然后 CreateDialogParam 函数把一个WM_INITDIALOG 消息（如果模板指定 DS_SETFONT 或 DS_SHELLFONT 类型，则加上一个 WM_SETFONT 消息）发送到对话框应用程序。
如果模板指定 WS_VISIBLE 风格，则函数显示对话框。最后 CreateDlalogParam 函数返回指向对话框的窗口句柄。

2. CreateDialog 函数返回之后，应用程序通过 ShowWindow 函数显示对话框（如果还没有显示）。应用程序通过DestroyWindow 函数来清除对话框。

3. 为了支持键盘快捷键操作和兼容其他对话框函数，在对话框的消息循环代码中必须调用 IsDialogMessage 函数。


需求：