Проверить существование элемента Версия 7 (Net)

Группа действий: Windows 

Описание

Действие проверяет, существует ли на экране указанный элемент

Иконка действия

Параметры и их настройки

СвойствоОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
ЭлементРесурс который хранит данные о выбранном элементе приложенияRobin.WinElement
Да
Тайм-аутВремя в миллисекундах, в течение которого будет происходить поиск нужного элементаRobin.Numeric
Нет
Номер окнаПорядковый номер окна, с которым должно работать действие. Если не указать номер окна, будет проверено первое окно. Нумерация начинается с 1Robin.Numeric
Нет
Результаты
РезультатЕсли значение равно "true", искомый элемент существует. Если значение равно "false", искомого элемента не существуетRobin.Booleantrue

Особые условия использования

 Робот вернет ошибку, если:

Действие ищет на экране элемент, запрашиваемый пользователем. Пользователь вводит свойства искомого элемента в поле "Элемент" . Действие возвращает результат "true", когда элемент найден. Если искомый элемент не находится, то результат действия будет "false".
Если найдено несколько элементов, которые подходят под указанные параметры, действие не должно вызывать ошибку. Действие возвращает значение "true".
Если в поле указан номер окна =1, а элемент находится в другом окне, то действие вернет "false".
Если указан номер окна за диапазоном количества окон (>), то взаимодействие происходит с первым открытым окном.
Если открыто одно окно, то параметр "Номер окна" игнорируется, не выпадет ошибка, НО в случае, когда введено отрицательное значение, робот выдаст ошибку.  

Номер окнаКоличество оконВзаимодействия робота
Не заполненоНесколько (2+)С первым открытым окном
Заполнено корректно (1+)Несколько (2+)С указанным окном
Заполнено несуществующим номером окна (10)Несколько (2)С первым открытым окном 
Заполнено корректно (1+)1 окноС единственным окном
Заполнено отрицательным числом1 или несколько оконОшибка

Окна идут в порядке, в котором запускались. 

Пример использования 

Задача

Открыто окно. Необходимо определить существует ли на нем элемент.

Решение

 Воспользоваться действиями "Проверить существование элемента", "Если", "Сообщение". 

Реализация

  1. Перенести действие "Проверить существование элемента" и заполнить его параметры.
    Элемент необходимо получить с помощью инструмента WinSpy. Работа с WinSpy описана в разделе Получение win-элемента.
    Установка тайм-аута, в целом, не приводит к увеличению времени выполнения действия сверх того времени, которое потребуется для того, чтобы элемент, который мы используем в действии стал видимым и доступным. В течение установленного тайм-аута действие пытается получить доступ к элементу с которым работает. Как только появляется доступ к элементу, ожидание тайм-аут заканчивается.
  2.  Перенести действие "Если" и заполнить его параметры.
    В поле условие, указываем результат действия "Проверить существование элемента".
  3. В ветку "Истина" перенести действие "Сообщение".
    В поле "Текст сообщения" указать текст "Элемент найден". Таким образом, если элемент будет найден в окне, то робот выведет данное сообщение.
  4. В ветку "Ложь" перенести действие "Сообщение".
    В поле "Текст сообщения" указать текст "Элемент не найден". Таким образом, если элемент не будет найден в окне, то робот выведет данное сообщение.
  5. Нажать на кнопку "Старт" в верхней панели. Итоговая схема робота будет выглядеть таким образом.

Результат

Программный робот отработал успешно.

Элемент найден. Робот вывел соответствующее сообщение.