Все инструменты

ui_click

Экран, окна и интерфейс · macOS · Windows

Эффект: выполнение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Щелкает элемент (по element_ref, в его центре) или координату экрана (по coords). button left|right, count 2 = двойной щелчок. Возвращает {clicked, at:{x,y}} — `clicked` означает, что событие щелчка было ОТПРАВЛЕНО по этим координатам, а НЕ то, что приложение его обработало: CGEvent сообщает одинаковый успех для занятого, модального или игнорирующего ввод приложения. Подтвердите эффект с помощью ui_wait_for_element или ui_read_tree, а не доверяйте `clicked`. element_disabled возвращается ТОЛЬКО когда приложение действительно публикует AXEnabled=false; элемент управления, который вообще не публикует AXEnabled, считается имеющим неизвестное состояние и по нему выполняется щелчок. Требуется разрешение Accessibility.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Каноническая техническая схема на английском — macOS
{
  "properties": {
    "button": {
      "description": "Default left.",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "by": {
      "description": "Default element if element_ref given, else coords.",
      "enum": [
        "element",
        "coords"
      ],
      "type": "string"
    },
    "coords": {
      "description": "{x,y} in global screen points.",
      "type": "object"
    },
    "count": {
      "description": "1 (default) or 2 for double-click.",
      "type": "integer"
    },
    "element_ref": {
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

Пример документации для ui_click. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "coords": {
    "x": 100,
    "y": 100
  }
}

Windows

Назначение

Щелкает элемент (по element_ref, в его центре) или координату экрана (по coords). button left|right, count 2 = двойной щелчок. Возвращает {clicked, at:{x,y}} — `clicked` означает, что щелчок был ОТПРАВЛЕН по этим координатам, а НЕ то, что приложение его обработало: SendInput сообщает одинаковый успех для занятого или модального приложения. Подтвердите эффект с помощью ui_wait_for_element или ui_read_tree, а не доверяйте `clicked`.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Каноническая техническая схема на английском — Windows
{
  "properties": {
    "button": {
      "description": "Default left.",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "coords": {
      "description": "{x,y} in global screen pixels.",
      "type": "object"
    },
    "count": {
      "description": "1 (default) or 2 for double-click.",
      "type": "integer"
    },
    "element_ref": {
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

Пример документации для ui_click. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "coords": {
    "x": 100,
    "y": 100
  }
}