Один поток на запуск. Каждый сработавший скрипт выполняется в собственном потоке, со своими
переменными и кэшами перечислений. Два жеста, выполненные почти одновременно, работают
параллельно. Именованная блокировка не даёт им перемешивать общую работу. Исключение —
монитор COM-порта: его строки обрабатываются по одной, в порядке поступления. Параметр
Максимум одновременных действий ограничивает, сколько их выполняется одновременно; при его
достижении происходит то же, что и по горячей клавише остановки всех действий
(Параметры скриптов).
Скрипт может блокироваться.UtilityWait, окна сообщений, ShellRunProgram с ожиданием
завершения и чтение из COM-порта блокируют поток своего скрипта и больше ничего. Ввод с мыши и
клавиатуры продолжает поступать.
Остановка.EngineStopAllActions() и кнопка Остановить все в консоли завершают каждый
выполняющийся скрипт на его следующей инструкции, поэтому бесконечный цикл всегда можно
остановить. Встроенные функции, которые ждут, замечают запрос на остановку во время ожидания:
UtilityWait, ожидание блокировки и данных COM-порта, WindowWaitFor, WindowWaitClose,
ClipboardCopySelection, KeyboardTypeText (останавливается перед следующим символом),
MacroPlayTemporary, SnippetExecuteScript, AutoHotkeyExecuteScript
(завершает процесс AutoHotkey), ShellRunProgram с ожиданием завершения (оставляет программу
работать), ShellShowToast, MultimediaPlayMp3File и UIShowConsole. Остальные встроенные
функции, включая окна сообщений, сначала завершают текущий вызов. Горячая клавиша остановки всех
действий делает то же самое, а также удаляет все таймеры, отслеживания папок и мониторы COM-портов
и отключает жесты, горячие клавиши и подстановку текста до Перезагрузить конфигурацию
(Горячая клавиша остановки всех действий).
Что сохраняется между запусками:
StorageSetValue/StorageGetValue: именованные значения любого типа, общие для всех скриптов, хранятся в памяти, пока
работает движок. StorageGetValue для имени, которое никогда не задавалось, возвращает
Integer 0. Хранится до 1 024 значений с именами до 256 символов и Text до 32 768
символов; превышение предела останавливает действие с ошибкой.
StorageSetPersistentValue/StorageGetPersistentValue: то же самое с теми же пределами, но
значения хранятся в storage.toml рядом с файлом конфигурации и сохраняются после перезапуска.
Window сохранить нельзя (пример).
Свойства окна (WindowSetPropertyInteger/…Text): значения, привязанные к одному окну и
исчезающие при его закрытии или при завершении работы Input.Observer. Текстовое значение —
не более 1 024 символов, одновременно можно хранить до 512 текстовых значений.
Именованные таймеры, отслеживание папок и мониторы COM-портов, которые движок продолжает
выполнять после завершения создавшего их скрипта, пока их не удалят или не нажмут горячую
клавишу остановки всех действий. Перезагрузка или сохранение конфигурации их не завершает; скрипт
события Конфигурация загружена, который снова создаёт такой объект с тем же именем, заменяет его.
Скрипты, переданные как Text.TimerCreate, FolderWatchCreate и SerialMonitorCreate
принимают скрипт в виде аргумента Text. Он компилируется и запускается отдельно при каждом
срабатывании, поэтому у него свежие переменные и он не видит переменных создавшего его скрипта.
Кавычки внутри него требуют экранирования \"; либо держите скрипт во фрагменте и передавайте
SnippetGetScript("name").
Контекст. Встроенные функции Context* описывают то, что запустило текущее выполнение: жест,
его точки и ограничивающий прямоугольник, окно и элемент управления под ним, кнопку, событие
отслеживания или строку с COM-порта. У скрипта таймера нет контекста триггера. Скрипт
отслеживания папки получает значения ContextGetWatch*, а скрипт монитора COM-порта — значения
ContextGetSerial*. Скрипт события колеса получает ContextGetWheelDelta и
ContextGetWheelHorizontal, а скрипт события кнопки мыши или колеса получает позицию указателя из
ContextGetEventX и ContextGetEventY.
Фрагменты — именованные скрипты в конфигурации. SnippetExecuteScript выполняет фрагмент до
конца, прежде чем вызывающий скрипт продолжит работу, и возвращает true, только если фрагмент
выполнен до конца. Фрагмент разделяет контекст триггера
вызывающего скрипта, но имеет собственные переменные.
Безопасный режим блокирует все скрипты, кроме запущенных из диагностической консоли.