MSGBOXPARAMSA 结构（winuser.h）

项目
11/20/2024

包含用于显示消息框的信息。 MessageBoxIndirect 函数使用此结构。

语法

typedef struct tagMSGBOXPARAMSA {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCSTR         lpszText;
  LPCSTR         lpszCaption;
  DWORD          dwStyle;
  LPCSTR         lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSA, *PMSGBOXPARAMSA, *LPMSGBOXPARAMSA;

成员

cbSize

类型：UINT

结构大小（以字节为单位）。

hwndOwner

类型：HWND

所有者窗口的句柄。此成员可以 NULL。

hInstance

类型：HINSTANCE

包含由 lpszIcon 成员标识的图标资源的模块句柄，以及由 lpszText 或 lpszCaption 成员标识的字符串资源。

lpszText

类型：LPCTSTR

包含要显示的消息的以 null 结尾的字符串或字符串资源的标识符。

lpszCaption

类型：LPCTSTR

包含消息框标题的以 null 结尾的字符串或字符串资源的标识符。如果此成员 NULL，则使用默认标题错误。

dwStyle

类型：DWORD

对话框的内容和行为。此成员可以是为 MessageBoxEx 函数的 uType 参数描述的标志的组合。

此外，如果希望消息框显示由 lpszIcon 成员指定的图标，则可以指定 MB_USERICON 标志（0x000000080L）。

lpszIcon

类型：LPCTSTR

标识图标资源。此参数可以是以 null 结尾的字符串，也可以是传递给 MAKEINTRESOURCE 宏的整数资源标识符。

若要加载其中一个标准系统定义的图标，请将 hInstance 成员设置为 NULL，并将 lpszIcon 设置为 LoadIcon 函数列出的值之一。

如果 dwStyle 成员未指定 MB_USERICON 标志，则忽略此成员。

dwContextHelpId

类型：DWORD_PTR

标识帮助上下文。如果发生帮助事件，则此值是在消息框发送到所有者窗口或回调函数 HELPINFO 结构中指定的。

lpfnMsgBoxCallback

类型：MSGBOXCALLBACK

指向处理消息框帮助事件的回调函数的指针。回调函数具有以下形式：

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

如果此成员 NULL，则当发生帮助事件时，消息框会将 WM_HELP 消息发送到所有者窗口。

dwLanguageId

类型：DWORD

显示预定义的推送按钮中包含的文本的语言。此值必须采用由 MAKELANGID 宏返回的表单中。

有关支持的语言标识符的列表，请参阅语言标识符。请注意，每个本地化版本的 Windows 通常仅包含一组有限的语言的资源。因此，例如，美国版本提供 LANG_ENGLISH，法语版本提供 LANG_FRENCH，德语版本提供 LANG_GERMAN，日语版本提供 LANG_JAPANESE。每个版本都提供 LANG_NEUTRAL。这会限制可用于 dwLanguageId 参数的值集。在指定语言标识符之前，应枚举安装在系统上的区域设置。

言论

注意

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

要求

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