IConsole::MessageBox 方法 (mmc.h)
显示消息框。
语法
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 |