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

Ключ

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

...

Window focus element Version 20 (Net)

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

Описание

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

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

Image Removed

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

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

  1. Элемент - Ресурс который хранит данные о выбранном элементе приложения. 
  2. Тайм-аут  - Время в миллисекундах, в течении которого будет происходить поиск нужного окна. 
  3. Тип события - Варианты вызываемого события. 
  4. Фокус - Если стоит чек-бокс на  true, то вызвать фокус на элементе. 
  5. Номер окна  - Если найдено несколько окон, то действие взаимодействует с окном под указанным номером. 
  6. Сдвиг по оси х   - Количество пикселей, на которые сместится точка координат по горизонтали от центра указанного элемента. 
  7. Сдвиг по оси y - Количество пикселей, на которые сместится точка координат по вертикали от центра указанного элемента. Тип - Robin.Numeric. Обязательность заполнения поля - не обязательно

Настройки

...

Description

The action focuses on the window element by input device (mouse) element

Action icon

Image Added

Settings of parameters

PropertyDescriptionTypeFilling exampleMandatory field
Parameters
ElementResource with data of selected element in applicationRobin.WinElement
Yes
ТimeoutTime in milliseconds to find required window

Свойство

Описание

Тип

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

Обязательность заполнения поля

Параметры

Элемент

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

Robin.WinElement

Да

Тайм-аут

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

No

Тип события

Варианты вызываемого события
Event typeEvent typeRobin.String
Нет

No
Фокус
Focus
Если
If true,
то вызвать фокус на элементе
then focus on the element.Robin.Booleantrue
Нет
No

Номер окна

Если найдено несколько окон, то действие взаимодействует с окном под указанным номером
Window orderWhen found more than one window, action would interact with window defined by orderRobin.Numeric

Нет

Сдвиг по оси х

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

No
X-axis shiftNumber of pixels by which the coordinate point will shift horizontally from the center of the specified element.Robin.Numeric

Нет

Сдвиг по оси y

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

No
Y-axis shiftNumber of pixels by which the coordinate point will shift vertically from the center of the specified element.Robin.Numeric

Нет

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

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

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

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

Робот вернет ошибку, если:

  • координаты выходят за пределы экрана.

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

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

Задача

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

Решение

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

Реализация

...


No

Special conditions of use 

No prior activation of the window containing the item is required.

If there are several applications running that match the condition of this block, the operation will be performed with the last running one.

The pixel value can be positive or negative, depending on the way in which the focus should be shifted. Default value = 0 - no shift.

The robot will return an error if: 

  • coordinates go off the screen.

The group does not work with the taskbar, explorer, and workspace.

Example of use 

Task

Set the focus on the "File" element in notebook and click on the left mouse button. 

Solution

Use the "Window focus element" button. 

Implementation

  1. Assemble a robot scheme: 
    Image Added

  2. Set the “Window focus element” action parameters. The element for interaction must be obtained using WinSpy. Operation with WinSpy is described in the Interaction with a win element section. Setting a timeout, in general, does not increase the execution time of the action beyond the time it takes for the element we use in the action to become visible and available. During the set timeout, the action tries to access the element it is working with. As soon as the item is available, the waiting timeout expires.
    Image Added

  3. Click "Start" in the top panel. 

Result

The program robot completed successfully. The focus is set on the specified element

Результат

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