Pause

暂停脚本的当前线程.

Pause , OnOffToggle, OperateOnUnderlyingThread

参数

OnOffToggle

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

On: 暂停当前线程.

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

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

[v1.1.30+]: 十进制值 1, 0 和 -1 可以分别用来代替 On, Off 和 Toggle.

OperateOnUnderlyingThread

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

如果为空或省略, 则默认为 0. 否则, 请指定以下数字之一:

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

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

备注

默认情况下, 脚本也可以通过它的托盘图标或主窗口来暂停.

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

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

每当脚本的当前线程处于暂停状态时, 托盘图标变为 (或为 , 如果脚本同时也被挂起). 可以通过冻结图标来避免图标更改, 这通过指定 Menu 的 Icon 子命令的 Freeze 参数为 1 来实现. 例如:

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

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

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

如果紧挨着当前线程的线程被暂停, 则内置变量 A_IsPaused 包含 1, 否则为 0.

相关

Suspend, Menu, ExitApp, 线程, SetTimer

示例

Pause::Pause  ; Pause/Break 键.
#p::Pause  ; Win+P

DetectHiddenWindows, On
WM_COMMAND := 0x0111
ID_FILE_PAUSE := 65403
PostMessage, WM_COMMAND, ID_FILE_PAUSE,,, C:\YourScript.ahk ahk_class AutoHotkey