Документация 0.4 Справочник действий

Нажать клавиши

ui.sendHotkey · Windows

Нажимает сочетание клавиш (Ctrl+S, Alt+F4, Enter …)

Нажимает сочетание клавиш: Ctrl+S — сохранить, Alt+F4 — закрыть окно, Enter, F5, Ctrl+Shift+Esc. Используйте для команд, у которых нет кнопки, и для программ, где удобнее работать с клавиатуры.

Свойства #

Свойство Имя в файле Значение Обязательное По умолчанию Описание
Клавиши keys текст да — Напр. Ctrl+S, Alt+F4, Enter, Ctrl+Shift+Esc
Селектор selector селектор Windows нет — Необязательно: элемент, который получит фокус перед нажатием
Таймаут, мс timeoutMs число нет 10000

Результат #

Действие не возвращает значений.

Как работает #

  • Клавиши (keys) — одно сочетание: модификаторы Ctrl, Alt, Shift, Win и клавиша через +. Клавиши: буквы, цифры, Enter, Tab, Esc, Backspace, Delete, Insert, стрелки Up/Down/Left/Right, Home, End, PageUp, PageDown, Space, F1…F24.
  • Селектор (selector) — необязательно: элемент, который получит фокус перед нажатием. Без селектора клавиши получит активное сейчас окно — убедитесь, что это окно нужной программы.
  • Таймаут, мс (timeoutMs) — сколько ждать элемент селектора.

Ошибки #

Код Причина и что делать
InvalidArgument Сочетание пустое, неизвестная клавиша или модификатор стоит после клавиши (S+Ctrl)
ElementNotFound Элемент селектора не найден
Unknown Windows не принял ввод (окно программы запущено от администратора)

Пример #

{
  "type": "ui.sendHotkey",
  "props": {
    "keys": "Ctrl+S",
    "selector": { "kind": "uia", "path": [ { "processName": "notepad", "controlType": "Window", "name": "*Блокнот" } ] }
  }
}