Проверить существование элемента
...
Версия 7 (Net)
Группа действий: Windows
...
Описание
Действие проверяет, существует ли на экране указанный элемент.
...
Иконка действия
Image Added
Параметры и их настройки
заполнения | Свойство | Описание | Тип | Пример заполнения |
Обязательность | Обязательность заполнения поля |
| Параметры |
| Элемент | Ресурс который хранит данные о выбранном элементе приложения |
. |
| Да |
| Тайм-аут | Время в миллисекундах, в течение которого будет происходить поиск нужного элемента |
. |
| Нет |
| Номер окна | Порядковый номер окна, с которым должно работать действие. Если не указать номер окна, будет проверено первое окно. Нумерация начинается с 1 |
. |
| Нет |
| Результаты |
| Результат | Если значение равно |
«true»| "true", искомый элемент существует. Если значение равно |
«false»| "false", искомого элемента не существует |
. Особые условия использования
Робот вернет ошибку, если:
- окно не найдено
, - ;
- введен несуществующий номер окна.
Действие ищет на экране элемент, запрашиваемый запрашиваемый пользователем. Пользователь вводит свойства искомого элемента в поле «Элемент» "Элемент" . Действие возвращает результат «true»"true", когда элемент найден. Если искомый элемент не находится, то результом результат действия будет «false»"false".
Если найдено несколько элементов, которые подходят под указанные параметры, действие не должно вызывать ошибку. Действие возвращает значение "true".
Если в поле указан номер окна =1, а элемент находится в другом окне, то действие вернет "false".
Если указан номер окна за диапазоном количества окон (>), то взаимодействие происходит с первым открытым окном.
Если открыто одно окно, то параметр "Номер окна" игнорируется, не выпадет ошибка, НО в случае, когда введено отрицательное значение, робот выдаст ошибку.
| Номер окна | Количество окон | Взаимодействия робота |
|---|
| Не заполнено | Несколько (2+) | С первым открытым окном |
| Заполнено корректно (1+) | Несколько (2+) | С указанным окном |
| Заполнено несуществующим номером окна (10) | Несколько (2) | С первым открытым окном |
| Заполнено корректно (1+) | 1 окно | С единственным окном |
| Заполнено отрицательным числом | 1 или несколько окон | Ошибка |
Окна идут в порядке, в котором запускались.
Пример использования
Задача
: Открыто окно. Необходимо определить существует ли на нем элемент.
Image Removed
Image Added
Решение
Воспользоваться : воспользоваться действиями "Проверить существование элемента", "Если", "Сообщение".
Реализация
...
- Перенести действие "Проверить существование элемента" и заполнить его параметры.
Элемент необходимо получить с помощью инструмента WinSpy. Работа - Работа с WinSpy описана в
разделе - разделе Получение win-элемента.
Установка тайм-аута, в целом, не приводит к увеличению времени выполнения действия сверх того времени, которое потребуется для того, чтобы элемент, который мы используем в действии стал видимым и доступным. В течение установленного тайм-аута действие пытается получить доступ к элементу с которым работает. Как только появляется доступ к элементу, ожидание тайм-аут заканчивается.
Image Modified Перенести - Перенести действие "Если" и заполнить его параметры.
В поле условие, указываем результат действия "Проверить существование элемента".
Image Modified - В ветку "Истина"
переносим - перенести действие "Сообщение".
В поле "Текст сообщения" указываем - указать текст "Элемент найден". Таким образом, если элемент будет найден в окне, то робот выведет данное сообщение.
Image Modified - В ветку "Ложь"
переносим - перенести действие "Сообщение".
В поле "Текст сообщения" указываем - указать текст "Элемент не найден". Таким образом, если элемент не будет найден в окне, то робот выведет данное сообщение.
Image Modified - Нажать на кнопку "Старт" в верхней панели. Итоговая схема робота будет выглядеть
так:- таким образом.
Image Modified
Результат
...
Программный робот отработал успешно.
Image Modified
Элемент найден. Робот вывел соответствующее сообщение.
Image Removed
Image Added