Win-элементы – это ресурсы, в которых записаны уникальные идентификаторы, определяющие конкретный элемент (кнопка/поле/т.п) в окне Windows. Действия из группы «Windows» используют параметры из win-элемента для обнаружения этого элемента в окне и дальнейшей работы с ним.
Для создания и просмотра всех win-элементов необходимо на левой панели открыть вкладку «Ресурсы» и нажать на вкладку «Win-элементы».
В Robin Studio 2.0 также есть возможность автоматической записи сразу нескольких Win-элементов при помощи функции «Запись действий».
Создание и редактирование блоков Win-элементов
Все win-элементы автоматически распределяются по отдельным блокам в зависимости от названия процесса.
Чтобы создать новый win-элемент, нужно нажать на кнопку 
около надписи «Win элементы». Появятся поля, которые должны быть обязательно заполнены:
- «Process name» - название процесса, в одном из окон которого расположены необходимые элементы.
- «DisplayName» - название окна, в котором расположены элементы.
Имя окна и имя процесса могут совпадать.
На распределение элементов по блокам влияет только имя процесса, которое будет указано в параметрах элемента. При этом имя окна, указанное в параметрах элемента, может не совпадать с тем, которое указано в параметрах всего блока.
После заполнения полей необходимо нажать на кнопку «Сохранить».
Если нужно выйти с формы добавления win-элемента без сохранения внесенных изменений, нажмите на кнопку «Отмена» или на кнопку 
.
У каждого блока при наведении на него отображаются 3 кнопки:
- Добавить
– открывает окно для ввода параметров нового элемента. - Редактировать
– раскрывает поля «Имя процесса» и «Имя окна» для их редактирования. - Развернуть
– разворачивает блок в виде списка элементов, которые в него входят.
При переименовании блока (изменении названия процесса), название процесса автоматически меняется и во всех элементах, входящих в этот блок.
Однако при изменении названия процесса в параметрах элемента, этот элемент будет перенесен в блок с соответствующим названием. Если же блока с таким названием еще не было, он будет создан автоматически.
Добавление и редактирование Win-элементов
Чтобы добавить в необходимый блок новый элемент, необходимо нажать на кнопку 
в этом блоке.
Открывается окно с параметрами элемента:
Параметр | Тип | Назначение |
DisplayName* | поле | Поле является обязательным для заполнения Название win-элемента. При использовании шпиона или Рекордера заполняется автоматически именем окна, в котором был определен этот элемент |
Window name | поле | Имя окна, в котором робот будет определять необходимый элемент. При использовании Рекордера заполняется автоматически. Поиск возможен по частичному имени окна с применением регулярного выражения |
Process name | поле | Автоматически заполнено названием блока (названием процесса), на котором нажимали кнопку «Добавить». При использовании шпиона автоматически заполняется названием процесса, которое определил шпион. При использовании Рекордера или шпиона заполняется автоматически. |
Definition | поле | В данном поле указываются уникальные идентификаторы элемента. При использовании шпиона или Рекордера заполняется автоматически. Отображаются только те идентификаторы которые пользователь посчитал нужным оставить, а не все, которые могут быть у элемента |
XPath | поле | Путь до элемента, определяемый порядком следования элементов внутри друг друга |
| Order | поле | Порядковый номер элемента. Он работает с учетом выбранных свойств. Если по выбранным свойствам находится несколько элементов, order позволяет указать какой из этих найденных элементов нужен |
Spy | кнопка | При нажатии открывается окно шпиона для автоматической записи идентификаторов элементов |
Сохранить | кнопка | При нажатии все внесенные изменения сохраняются, а окно параметров закрывается |
Отмена | кнопка | При нажатии окно параметров закрывается, а все внесенные изменения, очищаются |
У каждого элемента при наведении на него есть две кнопки:
- Редактировать
- при нажатии открывается окно с параметрами элемента. Все поля доступны для редактирования. - Удалить
- при нажатии удаляет выбранный элемент.
Использование Win-spy
Для захвата win-элемента и его параметров необходимо нажать на кнопку SPY , далее, в появившемся окне нажать на кнопку [Захватить] в правой части окна, а затем нажать на клавишу [CTRL] и нажать ЛКМ.
В разделе «Дерево элементов окна» содержится информация о названии элемента, в разделе «Скриншот экрана» - скриншот элемента.
Примечание. В окне шпиона отображаются скриншот и идентификаторы только того элемента, который выбран в дереве элементов. Таким образом, можно просмотреть скриншоты и идентификаторы всех элементов, которые шпион смог определить в окне приложения, и сохранить нужный.
При нажатии на кнопку «Построить дерево» будет показано «дерево» (список элементов) выбранного приложения Windows.
При осществлении ЛКМ по элементу дерева будет показываться скриншот элемента и его параметры.
В разделе «Список свойств» содержится список параметров окна и набор кнопок. При нажатии на кнопку [Захватить] будет произведен «захват» окна Windows, при нажатии на кнопку [Найти] будет осуществлена проверка того, чтобы выбранный в левой части интерфейса элемент можно найти на экране.
Красной рамкой выделяется найденный элемент.
При нажатии на кнопку [Выбрать уникальные] осуществляется фильтрация выбранных параметров до минимального набора для идентификации элемента.
В поле «Порядок», в котором можно вручную указать порядковый номер (относительно других элементов в окне приложения) выбранного элемента. В этом случае поле не будет заполнено автоматически.
В поле "Номер окна" можно указать номер окна приложения.
В окне «Статус» отображатеся количество найденных элементов на экране.
Для сохранения выбранного элеента необходимо нажать на кнопку [Сохранить]. Выбранные элементы сохраняются в формате JSON.
Подстановка переменных / результатов в свойство Order
Алгоритм по подстановке значений в свойство Order указан в таблице ниже:
Предусловие:
| ||||
№ | Действие | Ожидаемый результат | ||
| 1 |
|
| ||
| 2 | Order в шпионе
|
| ||
| 3 | Запуск действия
|
| ||
| 4 | Изменение order в Definition
|
| ||
| 5 | Нет элемента, подходящего под заданный порядковый номер с заданными свойствами
|
| ||
Обзор
Инструменты контента