# SetKeyDelay

设置每次 Send 或 ControlSend 发送键击后自动的延时.

    SetKeyDelay Delay, PressDuration, "Play"

## 参数

Delay

  类型: 整数

  毫秒表示的时间. 使用 -1 表示无延时, 而 0 表示最小延时(然而如果使用了 Play 参数, 则 0 和 -1 都表示无延时). 留空此参数来保持当前的 Delay.

  如果脚本中没有使用过 SetKeyDelay, 则对于传统的 SendEvent 模式默认 Delay 为 10. 对于 SendPlay 模式, 默认 Delay 为 -1. 对于这两种模式, PressDuration(下面的) 默认为 -1.

PressDuration

  类型: 整数

  某些游戏和特殊的应用程序可能要求每次键击具有一定的按下时间; 即按下按键后, 持续一段时间, 然后才松开.

  使用 -1 表示无延时(默认), 而 0 表示最小延时(然而, 如果使用了 Play 参数, 则 0 和 -1 都表示无延时). 省略此参数来保持当前的 PressDuration 不变.

  注意: PressDuration 也会在修饰键(`Ctrl`, `Alt`, `Shift` 和 `Win`) 状态发生任何变化后产生一个延迟, 以支持正在发送的键.

Play

  类型: 字符串

  单词 Play 会把上面的设置应用于 SendPlay 模式而不是传统的 SendEvent 模式. 如果脚本没有使用过此参数, 则 SendPlay 模式的延时总是 -1/-1.

## 备注

注意: SetKeyDelay 不影响 SendInput; 在这种模式下, 键击之间没有延时. 当 SendMode Input 生效时, 对于 Send 同样如此.

在每次 Send 或 ControlSend 发送键击后会自动进行短暂的延时. 这样做提高了脚本的可靠性, 因为窗口有时无法响应快速的键击流.

在延迟(睡眠) 期间, 使当前线程不可中断.

由于操作系统计时系统的精确度, 延时可能会被向上取整到最近的 10 或 15 的倍数.

对于 Send/SendEvent 模式, 延时为 0 时实际内部会执行 Sleep(0), 这样会将脚本时间片的剩余部分分配给其他需要的进程. 如果没有进程需要, 那么 Sleep(0) 相当于完全没有延时. 与之相比, 延时为 -1 则从不休眠. 为了提高可靠性, 推荐使用 0 而不是 -1.

当延时设为 -1 时, 脚本的进程优先级会成为传统的 SendEvent 模式中键击发送速度的重要因素. 要提升脚本的优先级, 请使用 `ProcessSetPriority "High"`. 尽管这通常会使得键击发送的速度超过活动窗口的处理速度, 不过系统会自动对它们进行缓冲. 在 Send 函数完成后, 被缓冲的键击会继续到达目标窗口(即使此窗口现在已经不是活动窗口). 这种情况一般是不要紧的, 因为任何后续发送给相同窗口的键击会排列在缓冲中的那些键击之后.

内置变量 A_KeyDelay 包含了 Send/SendEvent 模式的当前 Delay 设置. A_KeyDuration 包含了 PressDuration 的设置, 同时 A_KeyDelayPlay 和 A_KeyDurationPlay 包含了 SendPlay 的设置.

每个新运行的线程(如 热键, 自定义菜单项或定时子程序) 都会以此函数的默认设置开始. 这个默认设置可以通过在脚本启动中使用此函数来改变.

## 相关

Send, ControlSend, SendMode, SetMouseDelay, SetControlDelay, SetWinDelay, Click

## 示例

在通过 Send 或 ControlSend 每次发送按键后, 产生尽可能小的延迟.

    SetKeyDelay 0

dftg