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, считается неизвестным и нажимается. Если элемент не публикует положение (некоторые элементы внутри веб-страниц), его прокручивают в область видимости; если положения всё равно нет, выполняется один левый щелчок через его действие доступности press, а ответ — {clicked, via:"press_action"} без `at`; если и это отклонено, возвращается ошибка no_bounds — используйте coords со снимка экрана. Требует разрешения Accessibility.

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

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

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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": {
      "description": "Element handle returned by ui_find_element or ui_read_tree; the click lands at that element's center. Needed when by=element, which is the default whenever element_ref is present.",
      "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`.

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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": {
      "description": "Element handle returned by ui_find_element or ui_read_tree; the click lands at that element's center. Pass this or coords — a non-empty element_ref wins, and coords is only read when it is absent.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

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

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