概述

显示一个向用户提示或确认信息的对话框，就像你会经常在各种程序里看到的那样：

这个对话框会占用焦点，并且会在手动关闭之前一直显示在屏幕上。动作也会停留在这个步骤，等待关闭后再继续执行。

目前支持两种模式：

• 标准模式：类似于windows内置弹窗，支持固定图标和按钮组合。
• 自定义模式：可自图标和按钮，显示内容比较灵活。

标准模式

与Windows内置的弹窗功能类似，支持固定可选的图标类型和按钮组合。与各语言的MessageBox.Show方法功能类似。

参数说明：

【模式】选择标准或是自定义模式。

【内容】消息的主要内容。

【标题】窗口标题。

【图标】显示在消息内容左侧的图标，以显示消息的类型。支持如下的图标样式：

• 信息
• 疑问
• 告警
• 错误

【按钮】定义对话框底部显示的按钮，支持如下的组合：

• 确定
• 确定和取消
• 是和否

【恢复活动窗口】是否在弹窗关闭后，将焦点还原到弹窗之前拥有焦点的窗口上。

输出参数

【选择的按钮】点击的按钮，可能为OK,Cancel,Yes,No。

【是否确认】是否点击的按钮为“确定”或“是”（表示正面选择的按钮）。

自定义模式

支持自定义按钮、图标，标题栏可显示动作图标。

参数说明：

【模式、内容、标题】请参考上文标准模式中的说明。

• 自定义模式下，消息内容也支持MarkDown格式，以MD:（MD+英文半角冒号）开始作为启用Markdown的标记，后面写实际的Markdown内容。（需1.39.20+版本）

【图标】可选预定义的图标名称，或手动输入Quicker所支持的各种自定义图标定义（无需输入中括号，如icon:一个可能不存在的文件.docx）。

【按钮】每行定义一个按钮，其格式可参考《用户选择》模块中的选项定义：

• 标题 只指定标题，自动使用和标题一样的内容作为按钮的值。
• 标题|值 自定义标题和值。
• [图标]标题(_X)(提示文字)|值 指定图标、快捷字母、提示文字和值。

下划线加字母表示按钮的快捷字母。如_C表示按钮的快捷字母为C。按Alt+C相当于按下此按钮。

【默认按钮】指定要预先选中并且高亮显示的按钮值。

输出参数：

【选中的按钮】所点击的按钮的值。如果没有选择，则输出空字符串。

示例动作

• 示例：弹窗消息

更新历史

• 20230617 v1.38.21 版本：增加自定义模式。
• 20230713 图标格式增加无需中括号的说明。
• 20230904 1.39.20 版本，自定义模式支持Markdown内容。