暂停

暂停脚本的当前线程。

#p::Pause ; 按一次 Win+P 会暂停脚本. 再按一次则取消暂停.
Pause [, On|Off|Toggle, OperateOnUnderlyingThread?]

参数

On|Off|Toggle

如果为空或省略, 则它默认为 Toggle. 否则, 请指定下列单词的其中一个:

Toggle：如果在当前线程下的潜在线程处于运行状态，则暂停当前线程，否则让潜在的线程恢复运行。

On：暂停当前线程。

Off：如果在当前线程下的线程已经处于暂停状态，则把它恢复到取消暂停状态。在其他情况下, 此命令没有效果.

OperateOnUnderlyingThread?

对于 Pause Off 会忽略此参数，因为它总是对潜在的线程进行操作。在打开或切换的两种情况时, 只有在打开 Pause 时才不会忽略此设置 (包含使用 Toggle 打开的情况).

请指定下面的其中一个数字:

0 (或省略): 此命令会暂停当前线程; 即正在运行 Pause 命令的这个线程.

1：此命令会标记在当前线程下面的线程为暂停，这样当那个线程恢复时它会结束它之前运行的命令（如果有）然后进入暂停状态。如果当前线程下面没有线程, 则暂停脚本自身, 这样阻止 计时器 的运行 (这样的效果和当脚本没有线程时使用了菜单项 "Pause Script" 一样).

注: A_IsPaused 包含了潜在线程的暂停状态.

备注

与 Suspend 禁用 热键 和 热字串 不同, 打开暂停状态会冻结 当前线程. 副作用是, 在它下面的任何被中断线程也将处于潜伏状态.

暂停任意线程后, 计时器 不会运行. 与之相比, 明确地启动的线程 (例如 热键 和 菜单项) 仍然可以运行; 但当它们的 线程 结束时, 潜在的线程仍会被暂停. 换句话说, 每个线程都能独立于其他线程被暂停.

每当脚本的 当前线程 处于暂停状态时, 托盘图标的颜色会从绿色变成红色. 通过冻结图标可以阻止这个图标颜色的改变, 这是使用最后一个参数为 1 的 Menu 命令实现的. 例如：

Menu, Tray, Icon, C:\My Icon.ico, , 1

要禁用计时器而不暂停脚本，请使用 Thread, NoTimers。

Pause 命令的功能和内置的菜单项 "Pause Script" 类似.

当脚本显示任意类型的 菜单 (托盘菜单, 菜单栏, GUI 上下文菜单, 等等) 时脚本总是处于停住状态 (虽然不是正式地暂停).

相关

Suspend, Menu, ExitApp, 线程, SetTimer

示例

Pause::Pause  ; 设置 "pause" 键为切换暂停功能的热键...
#p::Pause  ; ... 或者设置 Win+p 或其他热键.

; 发送 Pause 命令到另一个脚本。
DetectHiddenWindows, On
WM_COMMAND := 0x111
ID_FILE_PAUSE := 65403
PostMessage, WM_COMMAND, ID_FILE_PAUSE,,, C:\YourScript.ahk ahk_class AutoHotkey