История страницы
Получить связанные элементы Версия 1 (Net)
Группа действий: Windows Подгруппа "Работа с win-элементами"
...
Описание
Действие проверяет указанный элемент и возвращает связанные с ним элементы (родительские/дочерние/соседние)
Пример на "Блокноте":
Для элемента "Масштаб" соседним элементом будет "Строка состояния". Родительский элемент - "Вид". Дочерние элементы: "Увеличить", "Уменьшить", "Восстановить масштаб по умолчанию".
Иконка действия
Параметры
Входные параметры
Элемент Параметр, который хранит данные Win-элемента, координаты которого будут проверяться
Тип связи Выпадающий список с элементами: "Родительские элементы", "Дочерние элементы", "Соседние элементы"
...
Если глубина, указанная в параметре, больше фактической глубины в приложении, то берутся все элементы до фактической глубины
Тайм-аут Время в миллисекундах, в течение которого будет происходить поиск нужного элемента
Номер окна Порядковый номер окна, с которым будет взаимодействовать действие, если обнаружено несколько окон
При этом действие ищет только те окна, в которых должен находиться элемент согласно его параметрам
Положительное целое число от 1. По умолчанию - "1"
Выходные параметры
Результат Коллекция win-элементов.
Настройки
| Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля | Примечание |
| Параметры | |||||
| Элемент | Ресурс который хранит данные о выбранном элементе приложения | Robin.WinElement | Да | ||
| Тип связи | Тип связи между искомыми элементами и указанным. Можно искать элементы, которые являются родительскими, дочерними или соседними по отношению к указанному элементу. Соседние имеют общий родительский элемент с искомым элементом | Robin.Numeric | Да | Выпадающий список с элементами:
| |
| Глубина поиска | Уровень вложенности связанных элементов, до которого будет производиться поиск. Если указанная глубина больше фактической, действие вернет все элементы до фактической глубины Значение по умолчанию - 1. Параметр игнорируется, если в поле "Тип связи" выбрано значение "Соседние элементы" | Robin.Numeric | Нет | ||
| Тайм-аут | Время в миллисекундах, в течение которого будет происходить поиск нужного элемента | Robin.Numeric | Нет | ||
| Номер окна | Порядковый номер окна, с которым должно работать действие. Если не указать номер окна, будет проверено первое окно. Нумерация начинается с 1 | Robin.Numeric | Нет | ||
Особые условия использования
Если пользователь в "Тип связи" выбрал выбирает "Родительские элементы" и у указанного win-элемента отсутствует родитель, то в результате вернется пустая коллекция.
Если пользователь в "Тип связи" выбрал выбирает "Соседние элементы" и у указанного win-элемента отсутствуют соседи, то в результате вернется пустая коллекция.
Если пользователь в "Тип связи" выбрал выбирает "Дочерние элементы" и у указанного win-элемента отсутствуют дети, то в результате вернется пустая коллекция.
Метод обхода графа - в ширину.
Пример работы действия
- Пользователь указал элемент L, "Глубина поиска"=3, "Тип связи" = "Родительские элементы". Результат - коллекция с элементами E, B, A
- Пользователь указал элемент B, "Глубина поиска"=2, "Тип связи" = "Дочерние элементы". Результат - коллекция с элементами D, E, I, J, K, L
- Пользователь указал элемент F, "Тип связи" = "Соседние элементы". Результат - коллекция с элементами G,H
- Пользователь указал элемент A, "Тип связи" = "Родительские элементы". Результат - пустая коллекция
- Пользователь указал элемент A, "Тип связи" = "Соседние элементы". Результат - пустая коллекция
- Пользователь указал элемент I, "Тип связи" = "Дочерние элементы". Результат - пустая коллекция
Обзор
Инструменты контента