跳到主要内容

弹窗提示或确认

显示一个占用焦点的提示或确认对话框。关闭前会一直停在屏幕上，动作也停在这一步，等用户点完再继续。

当前模块定义​

sys:MsgBox基础Action
标准模块
输入 9 · 输出 2 · 枚举 4

输入参数

  • 模式operationEnum必填
    填写 固定输入默认 default
    标准默认default
    自定义custom
  • 消息内容messageText必填

    弹窗显示的消息内容。"自定义"模式时，也支持"MD:Markdown内容"。

    填写 输入或变量默认 Hello.
  • 标题titleText必填

    消息窗口标题。留空时自动使用动作名称。

    填写 固定输入默认 Quicker
  • 图标iconEnum必填

    消息窗口图标

    填写 固定输入条件 仅：default默认 Information
    5 个选项无、信息、疑问
    无None
    信息默认Information
    疑问Question
    警告Warning
    错误Error
  • 图标customIconText必填

    消息窗口图标。

    填写 输入或变量条件 仅：custom默认 Information
    5 个选项无、信息、疑问
    无
    信息默认Information
    疑问Question
    警告Warning
    错误Error
  • 按钮buttonsEnum必填

    消息窗口图标

    填写 固定输入条件 仅：default默认 OK
    确定默认OK
    确定/取消OKCancel
    是/否YesNo
  • 按钮customButtonsText必填

    每行定义一个按钮，格式为 "文本" 或 "[图标]显示文本(提示内容)|值"。

    填写 固定输入条件 仅：custom
    查看默认值
    [fa:Regular_Check:#4caf50]是(_Y)|Yes
[fa:Regular_Times:#dc3545]否(_N)|No
[fa:Light_Undo:#444444]取消(_C)|Cancel
  • 默认按钮defaultButtonText必填

    指定默认按钮的值。默认按钮以高亮颜色显示，可直接回车选择。

    填写 固定输入条件 仅：custom默认 Yes
  • 恢复活动窗口restoreFocusBoolean可选

    关闭弹窗后，是否将焦点还原到之前的活动窗口

    填写 固定输入默认 true

输出参数

  • 选择的按钮resultText

    点击的按钮，标准模式下结果可能为OK,Cancel,Yes,No，自定义模式下为按钮的值。

  • 是否确认okOrYesBoolean

    选择的按钮是否为"确定"或"是"

    条件 仅：default

两种模式：

  • 标准：类似 Windows 内置弹窗，图标和按钮是固定组合。
  • 自定义：可自定图标和按钮；内容更灵活，也支持 Markdown。

标准模式​

参数

弹窗提示或确认

弹窗显示提示或确认对话框
模式
消息内容
弹窗显示的消息内容。"自定义"模式时，也支持"MD:Markdown内容"。
标题
消息窗口标题。留空时自动使用动作名称。
图标
消息窗口图标
按钮
消息窗口图标
选择的按钮
ABC result
点击的按钮，标准模式下结果可能为OK,Cancel,Yes,No，自定义模式下为按钮的值。
是否确认
-- 选择变量 --
选择的按钮是否为"确定"或"是"
步骤注释
 
运行后延迟0保存(S)取消
运行效果拖动
  • 标题 → 标题栏
  • 内容 → 正文
  • 图标 → 消息图标
  • 按钮 → 按钮区

恢复活动窗口：关闭后是否把焦点还给弹窗前的窗口。

输出：

  • 选择的按钮：OK、Cancel、Yes、No
  • 是否确认：点的是「确定」或「是」

自定义模式​

参数

弹窗提示或确认

弹窗显示提示或确认对话框
模式
消息内容
弹窗显示的消息内容。"自定义"模式时，也支持"MD:Markdown内容"。
标题
消息窗口标题。留空时自动使用动作名称。
图标
消息窗口图标。
按钮
每行定义一个按钮，格式为 "文本" 或 "[图标]显示文本(提示内容)|值"。
默认按钮
指定默认按钮的值。默认按钮以高亮颜色显示，可直接回车选择。
选择的按钮
ABC result
点击的按钮，标准模式下结果可能为OK,Cancel,Yes,No，自定义模式下为按钮的值。
步骤注释
 
运行后延迟0保存(S)取消
运行效果拖动
  • 动作图标 → 标题栏图标
  • 标题 → 标题栏
  • 内容 → 正文
  • 图标 → 消息图标
  • 按钮 → 按钮区
  • 默认按钮 → 默认按钮

自定义模式下，消息内容以 MD:（半角冒号）开头可写 Markdown（1.39.20+）。语法见 MdXaml 扩展说明。

图标：可选预定义名称，或直接输入 Quicker 自定义图标（不要加中括号）。

弹窗提示或确认

弹窗显示提示或确认对话框
图标
消息窗口图标。
运行后延迟0保存(S)取消

按钮：每行一个，格式与用户选择的选项类似：

  • 标题：值与标题相同
  • 标题|值
  • [图标]标题(_X)(提示文字)|值

_C 表示快捷键 Alt+C。

默认按钮：填按钮的值（会高亮，回车即选）。

输出 选择的按钮 为所点按钮的值；未选则为空。

示例动作​

更新历史​

  • 20230617 v1.38.21：增加自定义模式。
  • 20230713：补充图标格式无需中括号的说明。
  • 20230904 1.39.20：自定义模式支持 Markdown 内容。
  • 20241029：增加 Markdown 扩展语法文档链接。

更新于