История страницы

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

...

Версия 23 (Net)

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

Данное действие предназначено для активизирования элемента.

Image Removed

Настройки

...

Описание

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

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

Image Added

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

Свойство

Англ. наименование

Свойство

Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Элемент

Element

Ресурс

,

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

Robin.WinElement

Windows-элемент

	Да
Тайм-аут

Time-out

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

элемента

окна

Robin.

Измеряется в миллисекундах.

Предельное время ожидания создания элемента.

По умолчанию значение равно "0".

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

Число5000НетКликClick option

Варианты вызываемого события/клика.

В выпадающем списке доступны значения:

Нет - No click.
ЛКМ - Force click.
ПКМ - Force right click.
Двойной ЛКМ - Force double click.

По умолчанию значение равно "No click".

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

СтрокаПКМ

Нет

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

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

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

Задача

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

Решение

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

Реализация

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

Результат

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

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

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

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

Новая версия Текущий

Ключ