MSGBOXPARAMSA 结构 (winuser.h)

包含用于显示消息框的信息。 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 参数一起使用的值集。 在指定语言标识符之前，应枚举系统上安装的区域设置。

注解

要求

请参阅

概念性

对话框

HELPINFO

LoadIcon

MAKEINTRESOURCE

MAKELANGID

MessageBoxEx

MessageBoxIndirect

其他资源

引用

WM_HELP