等待按键

等到用户按下指定键，或等到全部键盘键抬起。常用来等用户做完一件事再继续，或用按键在几个选项里选一个。

当前模块定义​

概述​

两种操作：

• 等待按下：等某个键盘或鼠标键（鼠标键 1.5.3+，不能拦截）。
• 等待所有按键抬起：等全部物理键盘键抬起（不含模拟键、不含鼠标）。常用来等 Ctrl / Shift / Alt 松开，避免叠到后面的模拟按键上。

参数说明​

操作类型：「等待按下」或「等待所有按键抬起」。

等待的按键：可指定多个。等组合键时只写非修饰键（Ctrl+S 写 S）。留空表示任意键盘键（不含鼠标）。多个键用英文逗号分隔，可以是键名或键值（见文末表）。

• LMenu,RMenu：左或右 Alt
• 112,113：F1 或 F2
• LButton,A：鼠标左键或 A
• wheel：垂直滚轮（1.28.5+）

ControlKey / Control、ShiftKey / Shift、Menu（Alt）会同时等左右两侧，输出的是实际按下的那一侧（如 LControlKey）。

修饰键：仅组合快捷键。英文逗号分隔的 ctrl,shift,alt,win。Ctrl+Shift+S 填 ctrl,shift。

最长等待秒数：超时则「步骤执行是否成功」为 False；「键名」「键值」是超时前最后一次按键，没按过则是 None 和 0。0 表示一直等。

拦截原始按键事件：拦截后按键不会进其它软件。只对键盘有效；组合键里的 Ctrl / Shift / Alt / Win 不会被拦截。鼠标键不能拦截。

等待按键抬起：按下后再等抬起，并输出保持时间。仅键盘。1.40.23+。

忽略模拟的按键：忽略动作或其它软件模拟的按键，只等物理键。

提示信息：屏幕上半透明提示。

字体名称：提示文字字体，多个用逗号分隔。

提示窗口位置：半透明提示出现的位置。

鼠标穿透：鼠标能否点穿提示窗点到下面。默认开启。

失败后停止动作：超时或失败后是否中止。默认开启。

输出​

输出的是实际按键。等 ControlKey 时，按下左侧就得到 LControlKey。

• 步骤执行是否成功：是否等到了目标按键（或全部抬起）。
• 键名：见文末表或 Keys 枚举。
• 键值：数字。可用下面的示例动作查看。
• 按下保持时间：开启「等待按键抬起」后，键盘按下的毫秒数。1.40.23+。

等待所有按键抬起​

示例动作​

键值对照表​

System.Windows.Forms.Keys：

相关链接​

更新历史​

• 1.1.33 起提供。
• 1.2.11 增加「等待的按键」。
• 1.5.3 支持鼠标按键（LButton / MButton / RButton / XButton1 / XButton2）；增加是否拦截原始按键。
• 20241023 去除失效链接。