IConsole：：MessageBox 方法 (mmc.h)

项目
02/29/2024

显示消息框。

语法

HRESULT MessageBox(
  [in]  LPCWSTR lpszText,
  [in]  LPCWSTR lpszTitle,
  [in]  UINT    fuStyle,
  [out] int     *piRetval
);

参数

[in] lpszText

指向包含要显示的消息的以 null 结尾的字符串的指针。

[in] lpszTitle

指向用于消息框标题的以 null 结尾的字符串的指针。如果此参数为 NULL，则使用默认标题“Error”。

[in] fuStyle

一个值，该值指定确定消息框的内容和行为的一组位标志。此参数可以是以下标志组的标志的组合，这些标志取自 Windows API MessageBox 的文档。

指定以下标志之一，以指示哪些按钮显示在消息框中。

MB_ABORTRETRYIGNORE

消息框包含三个按钮：“中止”、“重试”和“忽略”。

MB_OK

消息框包含一个按钮：“确定”。这是默认值。

MB_OKCANCEL

消息框包含两个按钮：“确定”和“取消”。

MB_RETRYCANCEL

消息框包含两个按钮：重试和取消。

MB_YESNO

消息框包含两个按钮：“是”和“否”。

MB_YESNOCANCEL

消息框包含三个按钮：“是”、“否”和“取消”。

指定以下标志之一以指示消息框中显示的图标：

MB_ICONEXCLAMATION、MB_ICONWARNING

消息框中将显示一个感叹号图标。

MB_ICONINFORMATION、MB_ICONASTERISK

消息框中会显示一个包含在圆圈中的“I”图标。

MB_ICONQUESTION

消息框中会显示一个问号图标。

MB_ICONSTOP，

MB_ICONERROR、MB_ICONHAND

消息框中会显示一个停止标志图标。

指定以下标志之一以指示默认按钮：

MB_DEFBUTTON1

第一个按钮是默认按钮，除非此组中的其他标志之一指定为默认值。

MB_DEFBUTTON2

第二个按钮是默认按钮。

MB_DEFBUTTON3

第三个按钮是默认按钮。

MB_DEFBUTTON4

第四个按钮是默认按钮。

指定以下标志之一来指示对话框的形式：

MB_APPLMODAL

用户必须先响应消息框，然后才能在当前窗口中继续操作。但是，用户可以转到其他应用程序的窗口并在这些窗口中操作。如果未指定MB_SYSTEMMODAL或MB_TASKMODAL，则默认值为MB_APPLMODAL。

MB_SYSTEMMODAL

在用户响应消息框之前，所有应用程序都将暂停。系统模态消息框用于通知用户需要立即注意的严重、具有潜在损害性的错误，应谨慎使用。

MB_TASKMODAL

类似于 MB_APPLMODAL，但在 Microsoft 基础类 (MFC) 应用程序中没有用处。此标志是为没有可用窗口句柄的调用方应用程序或库保留的。

此外，还可以指定以下标志：

MB_DEFAULT_DESKTOP_ONLY

当前接收输入的桌面必须是默认桌面;否则，函数将失败。默认桌面是在用户登录后运行应用程序的桌面。

MB_HELP

向消息框添加 “帮助 ”按钮。选择 “帮助 ”按钮或按 F1 将生成帮助事件。

MB_RIGHT

文本右对齐。

MB_RTLREADING

使用希伯来语和阿拉伯语系统的从右到左阅读顺序显示消息和描述文字文本。

MB_SETFOREGROUND

消息框将成为前台窗口。在内部，操作系统为消息框调用 SetForegroundWindow 函数。

MB_TOPMOST

使用 WS_EX_TOPMOST 窗口样式创建消息框。

MB_SERVICE_NOTIFICATION

调用方是通知用户某个事件的服务。函数在当前活动桌面上显示一个消息框，即使没有用户登录到计算机也是如此。

有关使用此标志的详细信息，请参阅 MessageBox 函数。

MB_SERVICE_NOTIFICATION_NT3x

此值对应于为早期版本的 Windows 为 MB_SERVICE_NOTIFICATION 定义的值。

[out] piRetval

指向返回值的指针。

返回值

此方法可以返回其中一个值。

注解

MessageBox 不应用于显示当管理单元没有焦点时发生的错误的。一般

仅当错误需要用户注意并且结果窗格包含有用信息（尽管有错误）时，才应使用 MessageBox。

在大多数情况下，MMC 消息 OCX 控件是显示错误消息的更合适方式。有关详细信息，请参阅使用 MMC 消息 OCX 控件。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	mmc.h
DLL	Mmcndmgr.dll

另请参阅

IConsole

通过