Сравнение версий

Старая версия 1

changes.mady.by.user Рукобратская Анна

Сохранено

по сравнению с

Новая версия 2

changes.mady.by.user Рукобратская Анна

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Получить связанные элементы Версия 2 (Net)

Группа действий: Windows  Подгруппа "Работа с win-элементами"

...

Описание

Действие проверяет указанный элемент и возвращает связанные с ним элементы (родительские/дочерние/соседние)

...

Для элемента "Масштаб" соседним элементом будет "Строка состояния". Родительский элемент - "Вид". Дочерние элементы: "Увеличить", "Уменьшить", "Восстановить масштаб по умолчанию".

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

Image RemovedImage Added

Параметры

Входные параметры

Элемент                Параметр, который хранит данные Win-элемента, координаты которого будут проверяться

...

                             Положительное целое число от 1. По умолчанию - "1"

Выходные параметры

Результат          Коллекция win-элементов

Настройки

Свойство
Property
Описание
Description
Тип
Type
Пример заполненияОбязательность заполнения поляПримечаниеПараметры ЭлементРесурс который хранит данные о выбранном элементе приложения
Filling exampleMandatory field
Parameters
ElementA resource that stores data about the selected application element.Robin.WinElement
ДаТип связи Тип связи между искомыми элементами и указанным. Можно искать элементы, которые являются родительскими, дочерними или соседними по отношению к указанному элементу. Соседние имеют общий родительский элемент с искомым элементомRobin.NumericДа

Выпадающий список с элементами:

  • Родительские элементы
  • Дочерние элементы
  • Соседние элементы

Yes
Type of connectionThe type of relationship between the elements being searched for and the specified element. You can search for elements that are parent, child, or neighbor to the specified element. Neighbors share a common parent element with the searched element.Robin.String
Yes
Search depthThe nesting level of related elements to which the search will be performed. If the specified depth is greater than the actual depth, the action will return all elements up to the actual depth. The default value is 1. The parameter is ignored if the «Neighboring items» value is selected in the «Type of connection» field.Robin.Numeric
No
Time-out, msThe time in milliseconds for which the desired element will be searched.Robin.Numeric
No
Window orderThe sequence number of the window that the action should work with. If you do not specify a window number, the first window will be checked. The numbering starts from 1.Robin.Numeric
No
Results
ResultA collection with related elements.Robin.Collection
Глубина поискаУровень вложенности связанных элементов, до которого будет производиться поиск. Если указанная глубина больше фактической, действие вернет все элементы до фактической глубины Значение по умолчанию - 1. Параметр игнорируется, если в поле "Тип связи" выбрано значение "Соседние элементы"Robin.NumericНетТайм-аутВремя в миллисекундах, в течение которого будет происходить поиск нужного элементаRobin.NumericНетНомер окнаПорядковый номер окна, с которым должно работать действие. Если не указать номер окна, будет проверено первое окно. Нумерация начинается с 1Robin.NumericНет


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

Если пользователь в "Тип связи" выбирает "Родительские элементы" и у указанного win-элемента отсутствует родитель, то в результате вернется пустая коллекция.

...

Метод обхода графа - в ширину.

Пример работы действия

  • Пользователь указал элемент L, "Глубина поиска"=3, "Тип связи" = "Родительские элементы". Результат - коллекция с элементами E, B, A
  • Пользователь указал элемент B, "Глубина поиска"=2, "Тип связи" = "Дочерние элементы". Результат - коллекция с элементами D, E, I, J, K, L
  • Пользователь указал элемент F, "Тип связи" = "Соседние элементы". Результат - коллекция с элементами G,H
  • Пользователь указал элемент A, "Тип связи" = "Родительские элементы". Результат - пустая коллекция
  • Пользователь указал элемент A, "Тип связи" = "Соседние элементы". Результат - пустая коллекция
  • Пользователь указал элемент I, "Тип связи" = "Дочерние элементы". Результат - пустая коллекция

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

Задача

Открыто окно с названием "Блокнот". Необходимо получить соседние, дочерние и родительские элементы элемента "Масштаб".

...

  1.  Собрать робота, состоящего из действий: 

  2. Настроить параметры действия "Запустить процессRun":

  3. Настроить параметр действия "Фокус на элементе ВидWindow focus element". Элемент необходимо получить с помощью инструмента WinSpy. Работа с WinSpy описана в разделе Получение win-элемента. Установка тайм-аута, в целом, не приводит к увеличению времени выполнения действия сверх того времени, которое потребуется для того, чтобы элемент, который мы используем в действии стал видимым и доступным. В течение установленного тайм-аута действие пытается получить доступ к элементу с которым работает. Как только появляется доступ к элементу, ожидание тайм-аут заканчивается.

  4. Настроить параметр действия "Фокус на элементе МасштабWindow focus element Scale". Элемент необходимо получить с помощью инструмента WinSpy. Работа с WinSpy описана в разделе разделе Получение win-элемента.

  5. Настроить параметр действия "Получить связанные элементыGet related elements". Выбираем ранее полученный с помощью инструмента WinSpy элемент "Масштаб1" и тип связи - Дочерние элементы:

  6. Настроить параметр действия "Получить длинуGet length". В поле Коллекция или массив, указываем результат действия "Получить связанные элементы":

  7. Настроить параметр действия "ВычитаниеSubtraction". Второй операнд будет 1:

  8. Настроить параметр цикла "ДляFor".  В В поле Конечное значение, указываем результат действия "ВычитаниеSubtraction":

  9. Настроить параметр действия "Получить значение по индексуGet value by index". В поле Коллекция, указываем результат действия "Получить связанные элементыGet related elements", в поле Индекс, указываем состояния итератора цикла "ДляFor":

  10. Настроить параметры действия "Завершить процессTerminate":
  11. Нажать на кнопку "Старт" в верхней панели. 

Результат

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

...

Дочерние элементы "Увеличить", "Уменьшить", "Восстановить масштаб по умолчанию" получены.


Пример 2

  1. Изменить параметр действия "Получить связанные элементыGet related elements". Выбираем ранее полученный с помощью инструмента WinSpy элемент "Масштаб1Scale1" и тип связи - Родительские элементы. 

  2. Нажать на кнопку "Старт" в верхней панели. 

Результат

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

...

  Родительский элемент "Вид" получен.

Пример 3

  1. Изменить параметр действия "Получить связанные элементы". Выбираем ранее полученный с помощью инструмента WinSpy элемент "Масштаб1Scale1" и тип связи - Соседние элементы. 

  2. Нажать на кнопку "Старт" в верхней панели. 

Результат

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

...