Клик мышью

Элемент выполняет клик мышью на выбранном элементе управления приложения рабочего стола или веб-приложения. Для корректной работы следует поместить данный элемент в один из следующих контейнеров:

• Присоединиться к приложению — для взаимодействия с элементами управления приложения рабочего стола.
• Открыть браузер или Присоединиться к браузеру — для взаимодействия с элементами управления веб-приложения.

Свойства

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

Процесс:

1. Кнопка мыши* — определяет тип клика. Доступные значения:
   • Левая кнопка BUTTON_LEFT — стандартный одиночный клик (значение по умолчанию). Окно программы должно быть развернутым.
   • INVOKE — одиночный клик левой кнопкой мыши. Это программный клик через Win32, при нем не наводится курсор, и окно приложения может быть свернутым. Однако нужно иметь в виду, что существуют приложения, не поддерживающие программный клик.
   • Левый двойной клик BUTTON_LEFT_DOUBLECLICK — двойной клик левой кнопкой.
   • Правая кнопка BUTTON_RIGHT — одиночный клик правой кнопкой (контекстный).
   • Средняя кнопка BUTTON_MIDDLE — клик колесиком.
2. Позиция — Определяет базовую точку внутри элемента управления, относительно которой будет произведён клик. По умолчанию Center. Чтобы выбрать другое значение, щелкните выпадающий список.

Важно: Позиция определяет начало системы координат при включённой Корректировке.

1. Прокрутить до видимости — Cвойство при активации автоматически прокручивает страницу до появления элемента в видимой области. Если опция отключена, действия будут выполняться без предварительной прокрутки. Функция доступна с версии 1.24.10
2. Шаблон поиска [String] — шаблон поиска элемента управления. Представляет собой JSON-файл, который содержит заданный набор свойств для идентификации компонента. Его можно сформировать вручную или автоматически. Для автоматического формирования используйте кнопку Выбрать компонент — она вызывает захват элемента управления в зависимости от категории приложения.
3. Элемент [LTools.UIInteraction.Model.UIControl] — ссылка на переменную, содержащую ранее найденный элемент.. Свойство может быть полезным, если нужный элемент уже был выбран ранее, и вы хотите его переиспользовать. Если элемент указан, шаблон поиска заполнять не нужно.
4. Активировать [Boolean] — определяет, нужно ли активировать окно приложения перед кликом. Если галочка установлена, то окно будет активировано.
5. Текущий пользователь [Boolean] — определяет, нужно ли искать элемент управления только среди процессов текущего пользователя.
6. Кнопка клавиатуры — при необходимости выберите клавишу клавиатуры. По умолчанию NONE - ни одна из клавиш. Чтобы выбрать другое значение, щелкните выпадающий список.
7. Таймаут* [Int32] — предельное время ожидания завершения процесса (мс). По умолчанию 10000.
8. Строгий таймаут [Boolean] — действие прерывается сразу по истечении лимита, указанного в свойстве Таймаут. По умолчанию выключено — робот может продолжать выполнение еще какое-то время, сверх установленного лимита, для полного обхода дерева контролов.
9. Область [System.Drawing.Rectangle ] — Позволяет ограничить область поиска элемента прямоугольником.
10. Координаты [System.Drawing.Point ] — координаты клика курсора.
11. Корректировка [Boolean] — определяет, нужно ли использовать корректировку координат. По умолчанию не используется.
12. Корректировка по X [Int32] — корректировка по оси X в пикселях. Работает только при включенном параметре Корректировка.
13. Корректировка по Y [Int32] — корректировка по оси Y в пикселях. Работает только при включенном параметре Корректировка.

Точное позиционирование клика

Для точного позиционирования клика внутри элемента управления используйте комбинацию свойств Позиция и Корректировка. Это особенно полезно при работе с составными элементами (например, в приложениях 1С), где разные части контрола выполняют различные функции.

Как работает позиционирование

• По умолчанию (Позиция = Center): клик выполняется в центр элемента
• С корректировкой: вы можете сместить точку клика относительно выбранной позиции

Направление корректировки

• Отрицательные значения: Смещение влево или вверх от выбранной позиции.
• Положительные значения: Смещение вправо или вниз от выбранной позиции.

Особенности для разных позиций:

Определение размеров элемента

Для расчета корректировки вам могут понадобиться размеры элемента:

1. Откройте Редактор шаблона поиска
2. Найдите свойство BoundingRectangle
3. Запомните ширину и высоту элемента, чтобы правильно рассчитать смещения.

Практические примеры

Пример 1: Клик в конкретную точку элемента

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

1. Позиция: Top Left
2. Корректировка: включить
3. Корректировка по X: [автоматически заполняется при захвате]
4. Корректировка по Y: [автоматически заполняется при захвате]

Пример 2: Клик в центр от правого нижнего угла

Для элементов размером 220×19 пикселей:

1. Позиция: Bottom Right
2. Корректировка: включить
3. Корректировка по X: -110 (220 / 2)
4. Корректировка по Y: -9 (19 / 2, округлено)

Пример 3: Клик по кнопке раскрытия списка справа

1. Позиция: Bottom Right
2. Корректировка: включить
3. Корректировка по X: -15 (отступ от правого края)
4. Корректировка по Y: -9 (центр по вертикали)

Рекомендации

1. Проверьте позицию курсора при первом запуске, чтобы убедиться, что робот кликает в нужную точку.
2. Используйте паузы перед кликом для визуальной проверки: можно добавить паузу в 1-2 секунды, чтобы наблюдать за поведением робота.
3. Для сложных элементов создавайте отдельные шаблоны поиска для разных частей контрола, например, для кнопки, текста или поля ввода.
4. Экспериментируйте с небольшими значениями корректировки при точной настройке — это поможет избежать неточных кликов, особенно для динамических элементов.

Эта функциональность особенно полезна при автоматизации приложений со сложными интерфейсами, таких как 1С, SAP, и других enterprise-систем.