Документация 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": "*Блокнот" } ] }
}
}