Документация 0.4 Справочник действий
Установить флажок
ui.setChecked · Windows
Включает или выключает флажок (CheckBox)
Включает или выключает флажок (CheckBox) в окне Windows-приложения. В отличие от клика, шаг ставит нужное состояние: если флажок уже в нём, ничего не меняется — повторный запуск процесса не „перещёлкнет“ его обратно.
Свойства #
| Свойство | Имя в файле | Значение | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|---|
| Селектор | selector |
селектор Windows | да | — | |
| Включён | checked |
да/нет | да | — | |
| Таймаут, мс | timeoutMs |
число | нет | 10000 |
Результат #
Действие не возвращает значений.
Как работает #
- Селектор (
selector) — путь к элементу от окна приложения. Задаётся пикером: кнопка «Указать на экране», наведите курсор на элемент и нажмите Ctrl. Проверить, что селектор находит элемент, — «Подсветить»; поправить вручную — «Изменить». Подробнее — Пикер элементов. - Включён (
checked) — нужное состояние: да или нет; можно задать выражением{{ needCopy }}. - У флажков с тремя состояниями робот переключает, пока не получит нужное.
- Таймаут, мс (
timeoutMs, по умолчанию 10000) — сколько ждать появления элемента; поиск повторяется каждые 200 мс. Если элемент нашёлся за 2 с и дольше, в лог пишется совет уточнить селектор.
Ошибки #
| Код | Причина и что делать |
|---|---|
ElementNotFound |
Элемент не найден за время ожидания: окно не открыто, свёрнуто под другим или интерфейс изменился. Проверьте селектор кнопкой «Подсветить», при необходимости укажите элемент заново |
InvalidArgument |
Элемент не поддерживает переключение (это не флажок) — проверьте селектор |
Unknown |
Флажок не принял нужное состояние (например, программа сбрасывает его сама) |
Timeout |
Флажок остаётся недоступным до конца таймаута |
Пример #
{
"type": "ui.setChecked",
"props": {
"selector": { "kind": "uia", "path": [ { "processName": "Tulpar.TestApp", "controlType": "Window", "name": "Tulpar Test App" }, { "controlType": "CheckBox", "automationId": "chkAgree" } ] },
"checked": true
}
}