Выбрать пункт

ui.selectItem · Windows

Выбирает пункт в выпадающем списке (ComboBox) или списке (ListBox)

Выбирает пункт в выпадающем списке (ComboBox) или в списке (ListBox) Windows-приложения: город, вид документа, счёт. Список при необходимости раскрывается и сворачивается сам.

Свойства #

Результат #

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

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

• Селектор (selector) — путь к элементу от окна приложения. Задаётся пикером: кнопка «Указать на экране», наведите курсор на элемент и нажмите Ctrl. Проверить, что селектор находит элемент, — «Подсветить»; поправить вручную — «Изменить». Подробнее — Пикер элементов. Указывайте сам список, а не пункт.
• Пункт (item) — видимый текст пункта; регистр не важен, допускаются * и ? (Бишкек*). Значение из переменной — {{ city }}.
• Таймаут, мс (timeoutMs, по умолчанию 10000) — сколько ждать появления элемента; поиск повторяется каждые 200 мс. Если элемент нашёлся за 2 с и дольше, в лог пишется совет уточнить селектор. После раскрытия списка пункт ищется ещё не меньше 2 с — пункты некоторых списков появляются с задержкой.

Ошибки #

При ошибке робот сохраняет снимок экрана: в студии он открывается по ссылке «Открыть скриншот» в «Лог», в оркестраторе — на странице задания.

Пример #

{
  "type": "ui.selectItem",
  "props": {
    "selector": { "kind": "uia", "path": [ { "processName": "Tulpar.TestApp", "controlType": "Window", "name": "Tulpar Test App" }, { "controlType": "ComboBox", "automationId": "cmbCity" } ] },
    "item": "{{ city }}"
  }
}