跳到主要内容

显示等待窗口

弹出一个等待窗口:让用户标明「可以继续了」、提前结束等待,或看进度、中止动作。

当前模块定义

概述

常见用法:循环复制时等用户点「开始粘贴」;配合 等待时间等待剪贴板变化 让用户提前结束。

点窗口下部按钮会关窗。点右上角 × 会询问是否终止当前动作。

参数说明

操作

  • 显示窗口:弹出等待窗口。
  • 更新窗口:改标题、提示、按钮和进度。
  • 检查是否关闭:返回窗口是否已被点关。
  • 关闭窗口(如果还开着的话):关掉窗口。
  • 等待用户关闭:等到用户关窗再继续。
  • 显示窗口并等待用户关闭:先显示再等待。

仅「显示窗口」「更新窗口」「显示窗口并等待用户关闭」时有下面这些外观参数。

窗口标题:标题栏文字。

提示文字:按钮上方的说明。

默认按钮上的文字:默认按钮文案。空则隐藏默认按钮。点默认按钮或附加按钮都会关窗。

窗口位置:屏幕各方位、跟随鼠标,或「上次的位置」(同一动作里再次弹出时,跟着手动拖过的位置)。

进度条参数当前值/最大值,如 90/100。空则不显示。前面加负号表示倒数:-10/100 显示为 90%。

附加操作按钮:每行一个按钮,格式与 用户选择 的选项相同,排在默认按钮左侧。

按钮文字可用 [fa:Light_Pen:#99AAFF]标题(Tooltip)(1.5.21+)。

图标大小:按钮图标逻辑像素,默认 16。

文字大小:按钮文字逻辑像素,默认 12。

关闭窗口时(点右上角x按钮)后停止动作:点 × 后是否停动作。默认开启。仅显示 / 显示并等待。

自动关闭:几秒后自动关。0 表示不自动关。仅显示 / 显示并等待。

激活模式(仅显示 / 显示并等待):

  • 不支持激活(不占用焦点,仅能使用鼠标操作)
  • 支持激活,打开时不抢占焦点
  • 支持激活,打开时抢占焦点(会让之前的窗口失去焦点)

帮助按钮内容:Markdown。点帮助按钮弹出。仅显示 / 显示并等待。

输出

仅「检查是否关闭」「等待用户关闭」「显示窗口并等待用户关闭」时有输出。

  • 是否已关闭:仅「检查是否关闭」。用户是否点了按钮关窗。
  • 选择的按钮:点了哪个附加按钮。点默认按钮则返回空。

结合其他模块

等待时间 打开「等待窗口关闭时取消」后,关掉等待窗口就会提前结束等待(等待须超过 1000ms)。等待剪贴板变化 同样可以提前结束。

通常用法

  1. 循环前用「显示窗口」。
  2. 循环里需要时「更新窗口」;要判断用户是否点了按钮就「检查是否关闭」,再决定是否跳出。
  3. 结束时「关闭窗口」。

示例动作

相关链接

更新于