(or to 
if the script is also suspended), whenever the script's current thread is in a paused state. This icon change can be avoided by freezing the icon, which is achieved by using TraySetIcon(,, true).Pauses the script's current thread or sets the pause state of the underlying thread.
Pause UnderlyingThreadState
Type: Integer
If omitted, the current thread is paused. Otherwise, specify one of the following values:
1 or True: Marks the underlying thread as paused. The current thread is not paused and continues running. When the current thread finishes, the underlying thread resumes any interrupted function the underlying thread was running. Once the underlying thread finishes the function (if any), it enters a paused state. If there is no thread underneath the current thread, the script itself is paused, which prevents timers from running (this effect is the same as having used the menu item "Pause Script" while the script has no threads).
0 or False: Unpauses the underlying thread.
-1: Toggles the pause state of the underlying thread.
By default, the script can also be paused via its tray icon or main window.
Unlike Suspend -- which disables hotkeys and hotstrings -- turning on pause will freeze the thread (the current thread if UnderlyingThreadState was omitted, otherwise the underlying thread). As a side-effect, any interrupted threads underneath it will lie dormant until the current thread is unpaused and finishes.
Whenever any thread or the script itself is paused, timers will not run. By contrast, explicitly launched threads such as hotkeys and menu items can still be launched; but when their threads finish, the underlying thread will still be paused. In other words, each thread can be paused independently of the others.
The tray icon changes to (or to if the script is also suspended), whenever the script's current thread is in a paused state. This icon change can be avoided by freezing the icon, which is achieved by using TraySetIcon(,, true).
To disable timers without pausing the script, use Thread NoTimers.
A script is always halted (though not officially paused) while it is displaying any kind of menu (tray menu, menu bar, GUI context menu, etc.)
The built-in variable A_IsPaused contains 1 if the thread immediately underneath the current thread is paused and 0 otherwise.
Suspend, Menu object, ExitApp, Threads, SetTimer
Use Pause to halt the script, such as to inspect variables.
ListVars Pause ExitApp ; This line will not execute until the user unpauses the script.
Press a hotkey once to pause the script. Press it again to unpause.
Pause::Pause -1 ; The Pause/Break key. #p::Pause -1 ; Win+P
Sends a Pause command to another script.
DetectHiddenWindows True WM_COMMAND := 0x0111 ID_FILE_PAUSE := 65403 PostMessage WM_COMMAND, ID_FILE_PAUSE,,, "C:\YourScript.ahk ahk_class AutoHotkey"