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

Ключ

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

Скролл к элементу Версия

...

2 (Net)

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

...

Описание

Действие определяет координаты указанного элемента в окне и производит скролл к этому элементу, пока он не будет приближен максимально к центру экрана.

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

Image Removed

Параметры

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

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

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

Тайм-аут              Время в миллисекундах, в течение которого будет происходить поиск нужного элемента

Номер окна        Порядковый номер окна, с которым будет взаимодействовать действие, если обнаружено несколько окон.

                            При этом действие ищет только те окна, в которых должен находиться элемент согласно его параметрам. 

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

Настройки

Image Added

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

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

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

  1. Указанный элемент может находиться за пределами видимой части окна.
  2. Если элемент уже находится приближенно к центру экрана, то действие ничего не меняет, робот ошибку не выдает.

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

Задача

Открыть окно "Excel", необходимо найти нужный шаблон.
Image Added

Решение

Воспользоваться действием "Скролл к элементу".

Реализация

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

Результат

Программный робот отработал успешно.
Image Added
Исходное положение.
Image Added
Действие "Скролл к элементу" нашло нужный Win-элемент и пролистал к нему.
Image Added