MSGBOXPARAMSA 结构 (winuser.h)

项目
08/28/2023

包含用于显示消息框的信息。 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，则使用默认标题 Error 。

dwStyle

类型：DWORD

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

此外，如果希望消息框显示 lpszIcon 成员指定的图标，则可以 (0x00000080L) 指定MB_USERICON标志。

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)