Проверить существование элемента / Check for the existence of an element
Группа действий: Windows
Действие проверяет, существует ли на экране указанный элемент.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Элемент | Ресурс который хранит данные о выбранном элементе приложения. | Robin.WinElement | Да | |
Тайм-аут | Время в миллисекундах, в течении которого будет происходить поиск нужного элемента. | Robin.Numeric | Нет | |
Номер окна | Порядковый номер окна, с которым должно работать действие. Если по указанному номеру окно не найдено, будет проверено первое окно. Нумерация начинается с 1. | Robin.Numeric | Нет | |
| Результаты | ||||
Результат | Если значение равно "true", искомый элемент существует. Если значение равно "false", искомый элемент не существует. | Robin.Boolean | ||
Особые условия использования
Робот вернет ошибку, если:
- окно не найдено,
- введен несуществующий номер окна.
Действие ищет на экране элемент, запрашиваемый пользователем. Пользователь вводит свойства искомого элемента в поле «Элемент» . Действие возвращает результат «true», когда элемент найден. Если искомый элемент не находится, то результом действия будет «false».
Если найдено несколько элементов, которые подходят под указанные параметры, действие не должно вызывать ошибку. Действие возвращает значение "true".
Если в поле указан номер окна =1, а элемент находится в другом окне, то действие вернет "false".
Если указан номер окна за диапазоном количества окон (>), то взаимодействие происходит с первым открытым окном.
Если открыто одно окно, то параметр "Номер окна" игнорируется, не выпадет ошибка, НО в случае, когда введено отрицательное значение, робот выдаст ошибку.
| Номер окна | Количество окон | Взаимодействия робота |
|---|---|---|
| Не заполнено | Несколько (2+) | С первым открытым окном |
| Заполнено корректно (1+) | Несколько (2+) | С указанным окном |
| Заполнено несуществующим номером окна (10) | Несколько (2) | С первым открытым окном |
| Заполнено корректно (1+) | 1 окно | С единственным окном |
| Заполнено отрицательным числом | 1 или несколько окон | Ошибка |
Окна идут в порядке, в котором запускались.
Пример использования
Задача: Открыто 3 окна, необходимо проверить существование элемента "Поставить на паузу" (окно открыто последним).
Решение: воспользоваться действием "Проверить существование элемента".
Реализация:
- Перенести действие "Проверить существование элемента" и заполнить его параметры.
Элемент необходимо получить с помощью инструмента WinSpy. Работа с WinSpy описана в разделе Получение win-элемента
Установка тайм-аута, в целом, не приводит к увеличению времени выполнения действия сверх того времени, которое потребуется для того, чтобы элемент, который мы используем в действии стал видимым и доступным. В течение установленного тайм-аута действие пытается получить доступ к элементу с которым работает. Как только появляется доступ к элементу, ожидание тайм-аут заканчивается.
Окна идут в порядке, в котором запускались. (Поле "Номер окна").
- Нажать на кнопку "Старт" в верхней панели.
Результат:
Программный робот отработал успешно. Элемент найден, возвращено значение "true".
Обзор
Инструменты контента