#Persistent

Keeps a script permanently running (that is, until the user closes it or ExitApp is encountered).

#Persistent

A script is persistent if any of the following conditions are true:

• At least one hotkey or hotstring has been defined in the script or created by the Hotkey command or Hotstring function, even if it is not enabled.
• The keyboard hook or mouse hook is installed.
• The script contains any use of Gui, even if it has not been called.
• The script contains any use of OnMessage, or has called it dynamically or retrieved a reference with Func.
• The Input command has been called.
• The #Persistent directive is present anywhere in the script.

Use this directive to prevent the script from exiting after the auto-execute section (top part of the script) completes. This is useful in cases where a script contains timers and/or custom menu items but does not meet any of the other conditions listed above.

If this directive is added to an existing script, you might want to change some or all occurrences of Exit to be ExitApp. This is because Exit will not terminate a persistent script; it terminates only the current thread.

[v1.0.16+]: This directive also makes a script single-instance. To override this or change the way single-instance behaves, see #SingleInstance.

Like other directives, #Persistent cannot be executed conditionally.

Related

#SingleInstance, SetTimer, Menu, Exit, ExitApp

Examples

#Persistent