Установить курсор мыши

alt

Устанавливает курсор мыши на выбранном элементе управления.

Свойства

Описание общих свойств элемента см. в разделе Свойства элемента.
Символ * в названии свойства указывает на обязательность заполнения.

Свойство	Тип	Описание
Шаблон поиска	String	Шаблон поиска элемента управления
Элемент	LTools.UIInteraction.Model.UIControl	Ссылка на элемент управления
Координаты	System.Drawing.Point	Координаты курсора
Корректировка	Boolean	Определяет, нужно ли использовать корректировку координат
Корректировка по X	Int32	Корректировка по оси X относительно выбранной Позиции. Работает только при включенном свойстве Корректировка
Корректировка по Y	Int32	Корректировка по оси Y относительно выбранной Позиции. Работает только при включенном свойстве Корректировка
Позиция		Позиция курсора при клике. Корректировка рассчитывается относительно этой точки. По умолчанию `Center`. Для того, чтобы изменить значение, щелкните выпадающий список
Область		Область поиска компонента
Текущий пользователь	Boolean	Определяет, нужно ли искать только среди процессов текущего пользователя. С версии 26.1 включено по умолчанию.
Таймаут	Int32	Предельное время ожидания завершения процесса (мс). По умолчанию `10000`
Строгий таймаут	Boolean	Определяет, нужно ли прерывать выполнение элемента по истечении указанного времени в свойстве Таймаут. По умолчанию выключено - Робот может продолжать выполнение еще какое-то время, сверх установленного лимита, для полного обхода дерева контролов.

Особенности позиционирования курсора

Как работают Позиция и Корректировка

Свойство Позиция определяет базовую точку на элементе управления:

Значение	Базовая точка
`Center`	Центр элемента
`TopLeft`	Левый верхний угол
`TopRight`	Правый верхний угол
`BottomLeft`	Левый нижний угол
`BottomRight`	Правый нижний угол

Корректировка по X/Y смещает курсор относительно выбранной позиции:

Положительные значения — вправо (для левых позиций) или влево (для правых)
Отрицательные значения — влево (для левых позиций) или вправо (для правых)

Зависимость от типа автоматизации

Поведение корректировки зависит от типа автоматизации, указанного в контейнере Присоединиться к приложению:

Тип автоматизации	Поведение корректировки
UIAUTOMATION (по умолчанию)	Корректировка рассчитывается относительно выбранной позиции
UIAUTOMATION_UIA	⚠️ Корректировка может рассчитываться от левого верхнего угла элемента, игнорируя выбранную позицию

Рекомендация: Если курсор устанавливается не в ожидаемом месте, попробуйте переключить тип автоматизации на UIAUTOMATION или отключить «Быстрый поиск» в шаблоне поиска элемента.