Параметры шагов
Когда вы выбираете шаг, под ним открываются его поля — по одному на каждую нужную шагу подробность. Каждое поле подписано понятными словами. Наведите указатель на поле, чтобы увидеть подсказку о его назначении.
Виды полей
| Поле | Как выглядит | Что принимает |
|---|---|---|
| Текст | текстовое поле | любой текст |
| Целое число | текстовое поле | целое число, например 250 или -3, шестнадцатеричное число, начинающееся с 0x, например 0xB3, или именованную константу, например VirtualKey.MediaPlayPause |
| Число | текстовое поле | число с точкой в качестве десятичного разделителя, например 0.5, независимо от региональных параметров |
| Истина или ложь | переключатель | вкл. (true) или выкл. (false) |
| Выбор из именованных значений | раскрывающийся список ② | одно из перечисленных имён, например MouseButton.Primary; в нём можно и печатать |
| Окно | текстовое поле | окно из меню значений или из переменной, обычно Целевое окно |
| Клавиши (Отправить клавиши) | поле захвата клавиш | нажатое вами сочетание клавиш |
В поле любого вида можно также ввести $ и имя переменной, чтобы использовать значение, сохранённое
предыдущим шагом (Переменные).
Число в поле шага всегда использует точку в качестве десятичного разделителя и не использует разделители разрядов, каковы бы ни были ваши региональные параметры.
Именованные константы
Поле «Целое число» или «Число» принимает также именованную константу: пространство имён, точку и имя,
например VirtualKey.MediaPlayPause или AudioEndpoint.Playback, — те же имена, что использует скрипт
(Именованные константы). Вводите её точно, с теми же прописными буквами и
без пробелов. Шаг сохраняет имя, а действие при выполнении использует его число. Текстовое поле сохраняет
такое имя как введённый вами текст.
Поле «Клавиши»
У Отправить клавиши вместо текстового поля есть поле захвата. Щёлкните его (Щёлкните, чтобы задать
сочетание клавиш), затем нажмите сочетание. Записывается только сочетание; пока вы его задаёте, ничего не
отправляется. Клавиши, которые нельзя указать в сочетании, например мультимедийные, отклоняются с сообщением.
Чтобы нажать такие клавиши, используйте шаг Нажать и отпустить клавишу (KeyboardPressKey) с именем
клавиши, например VirtualKey.MediaPlayPause (Готовые рецепты).
Новые шаги сразу заполнены
Поля Окно нового шага изначально содержат Целевое окно: окно, над которым нарисован жест, или окно с фокусом для горячей клавиши или вводимого текста. Его переключатели изначально выключены. Все остальные поля изначально пусты, их заполняете вы.
Выбор значения из меню
У каждого поля, кроме Клавиши и переключателей, в конце есть маленькая стрелка (Выбрать значение). Она открывает меню подходящих полю значений ①. Помимо собственных полей шага, это меню есть у полей условия Значение и С чем сравнить и у его единственного Значение (Условия), у поля повтора Раз (Повторение шагов) и у поля Значение шага Задать переменную (Переменные).
| Раздел | Значения |
|---|---|
| Из того, что запустило действие | Целевое окно, Целевой элемент управления, Имя жеста, Имя действия, Имя группы приложений, Кнопка жеста, а также Левый край жеста, Верхний край жеста, Ширина жеста и Высота жеста |
| Читается при выполнении шага | Активное окно, Положение мыши по X, Положение мыши по Y, Текст из буфера обмена, Текущие дата и время |
| Сохранено предыдущими шагами | переменные, которые сохраняют шаги выше этого |
Меню перечисляет только значения вида, подходящего полю: поле «Число» принимает и целые числа, а поле, принимающее что угодно, принимает их все. Раз предлагает только целые числа; поля условия и значение Задать переменную предлагают все значения. Если ничего не подходит, меню сообщает Для этого поля нечего выбрать.
Выбранное значение показывается вместо текстового поля как элемент с его именем. Наведите на него указатель, чтобы увидеть, что это и как это записывает скрипт. Его кнопка Очистить очищает поле, чтобы можно было снова вводить текст.
Значения из раздела Из того, что запустило действие читают триггер: для действия, запущенного горячей клавишей или вводимым текстом, значения жеста пусты или равны 0. Все значения предлагаются везде, где выполняются шаги, потому что фрагмент можно вызвать откуда угодно.
На переключателе введённая ранее переменная показывается как элемент; очистка элемента выключает переключатель.
Проверки при вводе
Каждое поле проверяется по мере ввода. Проблема показывается красным под полем, а рамка поля становится красной:
| Сообщение | Значение |
|---|---|
| Это значение обязательно. | Имя переменной шага Задать переменную пусто. |
| Введите целое число (десятичное или шестнадцатеричное 0x), именованную константу либо $переменную. | В поле «Целое число» что-то другое. |
| Именованной константы с таким именем нет. Проверьте написание и регистр букв, как в VirtualKey.MediaPlayPause. | Поле «Целое число» или «Число» содержит пространство имён, точку и имя, не являющиеся именованной константой. |
| Введите число или $переменную. | В поле «Число» что-то другое. |
| Введите true или false либо $переменную. | В поле «Истина или ложь», введённом как текст, что-то другое. |
| Шаг не может выполнять встроенную функцию внутри аргумента. Сначала вынесите её в переменную. | Поле содержит вызов встроенной функции с чем-то в скобках (ниже). |
Пока поле содержит введённый текст, не прошедший проверку, — например буквы в поле «Целое число» или
«Число», имя, не являющееся именованной константой, или что-либо кроме true или false в поле «Истина или
ложь», — шаги не сохраняются: действие сохраняет последние сохранённые шаги, а под списком, пока вы не
исправите поле, показывается Шаги не сохранены: шаг N содержит недопустимое поле
(Проблемы).
Пустое поле не показывает сообщения и никогда не мешает сохранению; шаги сохраняются с пустым полем. При выполнении действия шаг с пустым полем числа, истины или лжи или окна останавливает действие в этом месте, а вывод Система консоли сообщает, что у этого аргумента неверный тип. Пустое текстовое поле выполняется как пустой текст, что для некоторых встроенных функций (имя файла, искомый заголовок окна) означает, что шаг ничего не делает.
Вынести в переменную
Поле содержит значение, переменную или одно из значений меню, но никогда не вызов встроенной функции с
аргументами. Если ввести такой вызов, например WindowGetTitle($w), поле предложит Вынести в
переменную. Это добавляет сразу над этим шагом шаг, который выполняет вызов и сохраняет результат под
именем, взятым из поля (например, window, затем window2), и помещает эту переменную в поле.
Вызов, у которого в скобках ничего нет, например ClipboardGetText(), допустим: это то же самое, что выбор
этого значения в меню значений. Так во всех полях с меню значений, включая поля условия, Раз и значение
Задать переменную.
Сохранение результата шага
Большинство встроенных функций дают результат: прочитанный текст, найденное окно или признак успеха.
Сохранить результат как ③ сохраняет его под именем, чтобы последующие шаги могли использовать его как
$имя. Оставьте поле пустым, чтобы игнорировать результат.
Шаг, сохраняющий результат, показывает в конце сводки «→ $имя». Имена следуют правилам из раздела Переменные.
Неверные виды при выполнении
Редактор проверяет форму вводимого, но не каждое правило встроенной функции. При выполнении действия значение неверного вида (например, переменная с текстом там, где встроенной функции нужно целое число) или значение, которое встроенная функция отклоняет, останавливает действие с ошибкой в диагностической консоли. См. Ошибки.