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

Ключ

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

...

Get element coordinates Version 23 (.Net)

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

Описание

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

Image Removed

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

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

...

Description

The action gets element center coordinates

Action icon

Image Added

Settings of parameters

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

...

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

  1. Левый верхний угол элемента - Координаты левого верхнего угла элемента.
  2. Центр элемента - Координаты центра элемента.
  3. Правый нижний угол элемента - Координаты правого нижнего угла элемента.

Настройки

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

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

No
НетРезультатыЛевый верхний угол элементаКоординаты левого верхнего угла элемента
Results
Top left corner of the elementCoordinates of the top left corner of the element.Robin.LocationPo int
  Центр элементаКоординаты центра элемента


Center of the elementThe coordinates of the center of the element.Robin.LocationPo int
  Правый нижний угол элементаКоординаты правого нижнего угла элемента


Bottom right corner of the elementCoordinates of the bottom right corner of the element.Robin.LocationPo int
  

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

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

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

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

Задача

Открыто окно параметров , необходимо получить координаты элемента поля поиска.

Image Removed

Решение

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

Реализация

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

Результат

Программный робот отработал успешно. 

Image Removed



Special conditions of use

Preliminary activation of the window containing the item is needed.

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

Example of use

Task

There is an open parameters window, get search field element coordinates.

Image Added

Solution

Use the "Get element coordinates" action.

Implementation

  1. Move the "Get element coordinates" action to the workspace.
    Image Added
  2. Set the "Get element coordinates" action parameters. Get the element with the WinSpy tool. Working with WinSpy is described in section Get Win-element
    Setting a timeout does not, in general, increase the execution time of an action beyond the time it takes for the item we are using in the action to become visible and accessible. 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.

Image Added

Element coordinates were obtained.

Image AddedКоординаты элемента получены.