DialogBoxIndirectA 宏（winuser.h）

项目
11/20/2024

从内存中的对话框模板创建模式对话框。 DialogBoxIndirect 在指定的回调函数通过调用 endDialog 函数终止模式对话框之前不会返回控件。

DialogBoxIndirect 作为对 DialogBoxIndirectParam 函数的调用来实现。

语法

void DialogBoxIndirectA(
  [in, optional]  hInstance,
  [in]            lpTemplate,
  [in, optional]  hWndParent,
  [in, optional]  lpDialogFunc
);

参数

[in, optional] hInstance

类型：HINSTANCE

用于创建对话框的模块的句柄。

[in] lpTemplate

类型：LPCDLGTEMPLATE

DialogBoxIndirect 用于创建对话框的模板。对话框模板包含描述对话框的标头，后跟一个或多个用于描述对话框中每个控件的其他数据块。该模板可以使用标准格式或扩展格式。

在对话框的标准模板中，标头是 DLGTEMPLATE 结构，后跟其他可变长度数组。每个控件的数据由 DLGITEMTEMPLATE 结构组成，后跟其他可变长度数组。

在对话框的扩展模板中，标头使用 DLGTEMPLATEEX 格式，控件定义使用 DLGITEMTEMPLATEEX 格式。

[in, optional] hWndParent

类型：HWND

拥有对话框的窗口的句柄。

[in, optional] lpDialogFunc

类型：DLGPROC

指向对话框过程的指针。有关对话框过程的详细信息，请参阅 DialogProc。

返回值

没有

言论

DialogBoxIndirect 宏使用 CreateWindowEx 函数创建对话框。 DialogBoxIndirect 然后将 WM_INITDIALOG 消息发送到对话框过程。如果模板指定 DS_SETFONT 或DS_SHELLFONT样式，该函数还会向对话框过程发送 WM_SETFONT 消息。该函数显示对话框（无论模板是否指定 WS_VISIBLE 样式），禁用所有者窗口，并启动其自己的消息循环来检索和调度对话框的消息。

当对话框过程调用 EndDialog 函数时，DialogBoxIndirect 销毁对话框，结束消息循环，启用所有者窗口（如果以前启用），并在调用 endDialog时返回对话框过程指定的 nResult 参数。

在标准对话框模板中，DLGTEMPLATE 结构，并且每个 DLGITEMTEMPLATE 结构必须在 DWORD 边界上对齐。在 DLGITEMTEMPLATE 结构后面的创建数据数组也必须在 DWORD 边界上对齐。模板中的所有其他可变长度数组必须在 WORD 边界上对齐。

在扩展对话框模板中，DLGTEMPLATEEX 标头以及每个 DLGITEMTEMPLATEEX 控件定义必须在 DWORD 边界上对齐。创建数据数组（如果有）在 DLGITEMTEMPLATEEX 结构之后也必须在 DWORD 边界上对齐。模板中的所有其他可变长度数组必须在 WORD 边界上对齐。

对话框模板中的所有字符串（如对话框和按钮的标题）必须是 Unicode 字符串。使用 MultiByteToWideChar 函数从 ANSI 字符串生成 Unicode 字符串。

例子

有关示例，请参阅在内存中创建模板。

注意

winuser.h 标头将 DialogBoxIndirect 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	winuser.h （包括 Windows.h）
库	User32.lib
DLL	User32.dll