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`。仅当应用确实发布 AXEnabled=false 时才返回 element_disabled；完全不发布 AXEnabled 的控件会被视为状态未知并执行点击。需要辅助功能权限。

必填输入

此平台的架构未声明必填输入，但仍可能存在可选选择器或运行时要求。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — 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`。