本文へスキップ
すべてのツール

ui_click

画面、ウインドウ、UI · macOS · Windows

効果: 実行. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

要素（element_ref を指定すると中心）または画面座標（coords を指定）をクリックします。button は left|right、count 2 はダブルクリックです。{clicked, at:{x,y}} を返します。`clicked` はクリックイベントがその座標に送出されたことを意味するだけで、アプリが反応したことを意味しません。CGEvent には配信確認がないため、ビジー状態、モーダル表示中、入力を受け付けないアプリでも、まったく同じ成功が返されます。`clicked` を信用せず、ui_wait_for_element または ui_read_tree で結果を確認してください。element_disabled が返されるのは、アプリが AXEnabled=false を実際に公開している場合のみです。AXEnabled をまったく公開しないコントロールは不明として扱われ、クリックされます。位置を公開しない要素（Web ページ内の一部のコントロール）はスクロールして表示するよう要求され、それでも位置がない場合は、アクセシビリティの押下アクションで左クリックが 1 回行われ、`at` のない {clicked, via:"press_action"} が返ります。それも拒否された場合のエラーは no_bounds で、スクリーンショットから得た coords を使ってください。アクセシビリティ権限が必要です。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — 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` はその座標へクリックを POST したという意味で、アプリが処理した確認ではありません。SendInput には配信確認がないため、ビジーまたはモーダルなアプリでも同じ成功になります。`clicked` を信頼せず ui_wait_for_element または ui_read_tree で効果を確認してください。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — 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"
}

ドキュメント例

ui_click のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

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