- 每次分派一个线程。每个被触发的脚本都在自己的线程上运行,拥有自己的变量和枚举缓存。两个相继很快触发的手势会同时运行。命名锁可以防止它们交错执行共享的工作。串口监视器是例外:它的各行按到达顺序逐一运行。同时运行的数量受最大同时运行操作数设置限制;达到该上限时,效果与停止所有操作热键相同(脚本设置)。
- 脚本可以阻塞。
UtilityWait、消息框、等待程序退出的 ShellRunProgram 以及串口读取,都只会阻塞其所在脚本的线程,不影响其他任何内容。鼠标和键盘输入照常传递。
- 停止。
EngineStopAllActions() 和控制台的全部停止会让每个正在运行的脚本在下一条指令处结束,因此死循环总是可以被停止。会等待的内置函数在等待期间也会察觉停止请求:UtilityWait、锁和串口等待、WindowWaitFor、WindowWaitClose、ClipboardCopySelection、KeyboardTypeText(在下一个字符之前停止)、MacroPlayTemporary、SnippetExecuteScript、AutoHotkeyExecuteScript(会结束 AutoHotkey 进程)、等待程序退出的 ShellRunProgram(程序会继续运行)、ShellShowToast、MultimediaPlayMp3File 和 UIShowConsole。其他内置函数(包括消息框)会先完成当前调用。停止所有操作热键的效果相同,此外还会删除所有计时器、文件夹监视和串口监视器,并在重新加载配置之前关闭手势、热键和文本扩展(全部停止热键)。
- 运行之间保留的内容:
StorageSetValue/StorageGetValue:任意类型的命名值,由所有脚本共享,只要引擎在运行就一直保存在内存中。对从未设置过的名称调用 StorageGetValue 会返回 Integer 0。最多可保存 1,024 个值,名称最多 256 个字符,Text 最多 32,768 个字符;超出限制会使操作因错误而停止。
StorageSetPersistentValue/StorageGetPersistentValue:与上面相同,限制也相同,但保存在配置文件旁边的 storage.toml 中,因此重新启动后值仍然存在。Window 无法保存(示例)。
- 窗口属性(
WindowSetPropertyInteger/…Text):附加到某个窗口上的值,该窗口关闭或 Input.Observer 退出时随之消失。一个文本值最多 1,024 个字符,同时最多可存储 512 个文本值。
- 命名计时器、文件夹监视和串口监视器:创建它们的脚本结束后,引擎会继续运行它们,直到它们被删除或按下停止所有操作热键。重新加载或保存配置不会结束它们;配置已加载 脚本以相同名称再次创建时,会替换原有的那个。
- 以 Text 形式传递的脚本。
TimerCreate、FolderWatchCreate 和 SerialMonitorCreate 以 Text 参数的形式接收一段脚本。每次触发时,这段脚本都会单独编译并分派,因此它拥有全新的变量,看不到创建它的脚本中的变量。其中的引号需要用 \" 转义,或者将脚本保存在代码片段中并传入 SnippetGetScript("name")。
- 上下文。
Context* 内置函数描述触发本次运行的内容:手势、其点和边界框、其下方的窗口和控件、按钮、监视事件或串口行。计时器的脚本没有触发上下文。文件夹监视的脚本可获取 ContextGetWatch* 的值,串口监视器的脚本可获取 ContextGetSerial* 的值。滚轮事件的脚本可获取 ContextGetWheelDelta 和 ContextGetWheelHorizontal,鼠标按钮事件或滚轮事件的脚本可通过 ContextGetEventX 和 ContextGetEventY 获取指针所在的位置。
- 代码片段是配置中的命名脚本。
SnippetExecuteScript 会将其运行完毕,然后调用方才继续;只有代码片段运行到结尾时才返回 true。它与调用方共享触发上下文,但拥有自己的变量。
- 安全模式会阻止所有脚本运行,从诊断控制台运行的脚本除外。