Фокус на элементе

Фокус на элементе Версия 21 (Net)

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

Описание

Действие устанавливает фокус на элементе окна по событию устройства ввода (мыши)

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

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

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

Элемент Ресурс который хранит данные о выбранном элементе приложения

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

Тип события Варианты вызываемого события

Фокус Если стоит чекбокс на true, то вызвать фокус на элементе

Номер окна Если найдено несколько окон, то действие взаимодействует с окном под указанным номером

Сдвиг по оси х Количество пикселей, на которые сместится точка координат по горизонтали от центра указанного элемента

Сдвиг по оси y Количество пикселей, на которые сместится точка координат по вертикали от центра указанного элемента. Тип - Robin.Numeric. Обязательность заполнения поля - не обязательно

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Элемент	Ресурс который хранит данные о выбранном элементе приложения	Robin.WinElement		Да
Тайм-аут	Время в миллисекундах, в течении которого будет происходить поиск нужного окна	Robin.Numeric		Нет
Тип события	Варианты вызываемого события: Нет- при выборе этого параметра не производится никаких событий ЛКМ - при выборе этого параметра производится физическое перемещение курсора мыши на элемент, производится вызов события клика ЛКМ ПКМ- при выборе этого параметра производится физическое перемещение курсора мыши на элемент, производится вызов события клика ПКМ Двойной ЛКМ- при выборе этого параметра производится физическое перемещение курсора мыши на элемент, производится вызов события двойным кликом ЛКМ Вызов метода элемента- при выборе этого параметра не производится физическое перемещение курсора мыши на элемент, а производится вызов события клика. Параметр работает в случае поддержки такого взаимодействия самим элементом	Robin.String		Нет
Фокус	Если true, то вызвать фокус на элементе	Robin.Boolean	true	Нет
Номер окна	Если найдено несколько окон, то действие взаимодействует с окном под указанным номером	Robin.Numeric		Нет
Сдвиг по оси х	Количество пикселей, на которые сместится точка координат по горизонтали от центра указанного элемента	Robin.Numeric		Нет
Сдвиг по оси y	Количество пикселей, на которые сместится точка координат по вертикали от центра указанного элемента	Robin.Numeric		Нет

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

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

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

Значение пикселей может быть положительным и отрицательным, зависит от того, в какую сторону надо сдвинуть фокус. Значение по умолчанию = 0 - нет сдвига.

Если координаты выходят за пределы экрана, то робот выдаст ошибку.

Группа не работает с панелью задач, проводником и рабочим столом.

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

Задача

Установить фокус на элементе “Файл” в блокноте и произвести клик ЛКМ.

Решение

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

Реализация

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

Результат

Программный робот отработал успешно. Фокус на указанном элементе установлен.

Дерево страниц