# 等待窗口 # 概述 等待窗口主要用于： 1. 需要用户指示中止循环的操作。如在连续复制粘贴动作中，请用户指示已完成复制，可以开始粘贴了。 1. 需要允许用户提前结束等待的动作：等待剪贴板变更、等待时间等。 1. 向用户显示进度信息。 1. 允许用户中止动作。 ![image.png](https://cdn.nlark.com/yuque/0/2019/png/272392/1552651047226-6739a081-c62a-49b1-a6e5-0b3c9df13577.png#height=171&id=t1cTS&margin=%5Bobject%20Object%5D&name=image.png&originHeight=257&originWidth=347&originalType=binary&ratio=1&size=11747&status=done&style=none&width=231)

用户点击等待窗口下部的按钮，窗口将关闭。
点击右上角的X按钮，将会弹窗询问是否终止当前动作。
# 模块参数设置
![image.png](https://cdn.nlark.com/yuque/0/2019/png/272392/1555550901849-08021264-d2ad-4122-af15-e6e0d5cc09c9.png#height=670&id=ies6m&margin=%5Bobject%20Object%5D&name=image.png&originHeight=1005&originWidth=1180&originalType=binary&ratio=1&size=99819&status=done&style=none&width=787)
## 输入参数 **操作类型：** - 显示窗口：弹出等待窗口。 - 更新窗口：更新等待窗口中显示的文本消息、按钮文字和进度信息。 - 检查是否关闭：返回等待窗口是否关闭了（点击了窗口上的按钮）。 - 关闭窗口（如果仍然打开）：关闭窗口。 - 等待用户关闭：开始等待，在用户关闭了“等待窗口”以后继续运行后续模块。 - 显示窗口并等待用户关闭：显示窗口并开始等待，在用户关闭了“等待窗口”以后继续运行后续模块。 **窗口标题：**等待窗口的标题文字。
**提示文字：**按钮上方的提示文字。
**默认按钮的文字：**在默认按钮上显示的文字。
**窗口位置：**具体的位置（屏幕的中间或4角），或上次的位置。上次的位置仅当在同一个动作里第二次或之后再显示等待窗口时使用（用于在手工拖动等待窗口后，下次弹出时仍然显示在拖动后的位置，从而避免遮挡屏幕内容）。
**进度条参数：**显示的进度信息。 如果为空则不显示进度条。格式为  “当前值/最大值”。如“90/100”等。 可以在前面增加负号-表示倒数。如“-10/100”，则显示为90%的进度。
**附加操作按钮：**定义显示在对话框上的其他按钮。每一行输入一个按钮的文字，格式与“[用户选择](https://www.yuque.com/quicker/help/userselect)”模块的选项定义相同。附加操作按钮，依次排列在默认按钮左侧。点击按钮/附加操作按钮时，等待窗口均会关闭。
![image.png](https://cdn.nlark.com/yuque/0/2019/png/272392/1555459175254-129844c6-2cc3-40d5-a74a-7bf5aade096a.png#height=137&id=s37RI&margin=%5Bobject%20Object%5D&name=image.png&originHeight=206&originWidth=469&originalType=binary&ratio=1&size=11091&status=done&style=none&width=313)
_（1.5.21版本）按钮_文字部分支持使用下面的格式设置图标和tooltip文字(可选)： - [fa:Light_Pen:#99AAFF]按钮标题(Tooltip文字内容)
【图标大小】指定按钮上图标的尺寸，默认为16。
【激活模式】窗口占用焦点的方式： - 不支持激活：窗口不占用焦点，即使点击窗口或上面的按钮也不占用。 - 支持激活，打开时不抢占焦点。 - 支持激活，打开时抢占焦点。抢占焦点将导致之前操作的窗口失去焦点。 ## 输出参数 当操作类型为“检查是否关闭”，输出是否关闭以及选择按钮的信息。
![image.png](https://cdn.nlark.com/yuque/0/2019/png/272392/1555459356128-a1f651ac-f65a-4260-b1f6-980fcc4eadd5.png#height=440&id=G1z5v&margin=%5Bobject%20Object%5D&name=image.png&originHeight=660&originWidth=1180&originalType=binary&ratio=1&size=52648&status=done&style=none&width=787)
**是否已关闭：**（仅适用于“检查是否关闭”操作），用于返回用户是否通过点击等待窗口上的按钮关闭了窗口。
**选择的按钮：**当使用“操作按钮”参数定义了更多按钮时，选择的是哪个按钮。 如果选择了默认按钮，则返回空，否则返回按钮所对应的值。
# 结合其他模块 等待窗口可以用于提前停止**等待剪贴板变化**和**等待时间模块**。
![image.png](https://cdn.nlark.com/yuque/0/2019/png/272392/1552659410019-10f846ac-5f55-4697-b5ed-25c409dbf001.png#height=375&id=JXcs3&margin=%5Bobject%20Object%5D&name=image.png&originHeight=563&originWidth=1180&originalType=binary&ratio=1&size=49772&status=done&style=none&width=787)
# 通常的使用方法 1. （在循环之前）调用“显示窗口”操作。 1. 在循环中 1. 如果需要更新进度和文字，调用“更新窗口”。 1. 如果需要判断用户是否关闭了窗口（点击了按钮上的动作），则调用“检查是否关闭”，并根据需要执行相应的操作，如跳出循环等； 3. 需要时，调用“关闭窗口”窗口操作销毁等待窗口。 # 示例动作 [https://getquicker.net/Sharedaction?code=80427a4f-78c4-4fc5-7b1a-08d6a9169e61](https://getquicker.net/Sharedaction?code=80427a4f-78c4-4fc5-7b1a-08d6a9169e61)