# Pause

暂停脚本的当前线程.

    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

## 示例

Press a hotkey once to pause the script. Press it again to unpause.

    Pause::Pause  ; The Pause/Break key.
    #p::Pause  ; Win+P

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

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

dftg