Pause

暂停脚本的当前线程.

#p::Pause ; 按一次 Win+P 会暂停脚本. 再按一次则取消暂停.
Pause , OnOffToggle, OperateOnUnderlyingThread

参数

OnOffToggle

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

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

On: 暂停当前线程.

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

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

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.

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

相关

Suspend, Menu, ExitApp, 线程, SetTimer

示例

#1

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

#2: 发送 Pause 命令到另一个脚本.

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