显示等待窗口
弹出一个等待窗口:让用户标明「可以继续了」、提前结束等待,或看进度、中止动作。
当前模块定义
概述
常见用法:循环复制时等用户点「开始粘贴」;配合 等待时间、等待剪贴板变化 让用户提前结束。
点窗口下部按钮会关窗。点右上角 × 会询问是否终止当前动作。
参数说明
操作:
- 显示窗口:弹出等待窗口。
- 更新窗口:改标题、提示、按钮和进度。
- 检查是否关闭:返回窗口是否已被点关。
- 关闭窗口(如果还开着的话):关掉窗口。
- 等待用户关闭:等到用户关窗再继续。
- 显示窗口并等待用户关闭:先显示再等待。
仅「显示窗口」「更新窗口」「显示窗口并等待用户关闭」时有下面这些外观参数。
窗口标题:标题栏文字。
提示文字:按钮上方的说明。
默认按钮上的文字:默认按钮文案。空则隐藏默认按钮。点默认按钮或附加按钮都会关窗。
窗口位置:屏幕各方位、跟随鼠标,或「上次的位置」(同一动作里再次弹出时,跟着手动拖过的位置)。
进度条参数:当前值/最大值,如 90/100。空则不显示。前面加负号表示倒数:-10/100 显示为 90%。
附加操作按钮:每行一个按钮,格式与 用户选择 的选项相同,排在默认按钮左侧。
按钮文字可用 [fa:Light_Pen:#99AAFF]标题(Tooltip)(1.5.21+)。
图标大小:按钮图标逻辑像素,默认 16。
文字大小:按钮文字逻辑像素,默认 12。
关闭窗口时(点右上角x按钮)后停止动作:点 × 后是否停动作。默认开启。仅显示 / 显示并等待。
自动关闭:几秒后自动关。0 表示不自动关。仅显示 / 显示并等待。
激活模式(仅显示 / 显示并等待):
- 不支持激活(不占用焦点,仅能使用鼠标操作)
- 支持激活,打开时不抢占焦点
- 支持激活,打开时抢占焦点(会让之前的窗口失去焦点)
帮助按钮内容:Markdown。点帮助按钮弹出。仅显示 / 显示并等待。
输出
仅「检查是否关闭」「等待用户关闭」「显示窗口并等待用户关闭」时有输出。
- 是否已关闭:仅「检查是否关闭」。用户是否点了按钮关窗。
- 选择的按钮:点了哪个附加按钮。点默认按钮则返回空。
结合其他模块
等待时间 打开「等待窗口关闭时取消」后,关掉等待窗口就会提前结束等待(等待须超过 1000ms)。等待剪贴板变化 同样可以提前结束。
通常用法
- 循环前用「显示窗口」。
- 循环里需要时「更新窗口」;要判断用户是否点了按钮就「检查是否关闭」,再决定是否跳出。
- 结束时「关闭窗口」。
示例动作
相关链接
更新于