ui_click

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

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

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

macOS

目的

element_ref の中心または coords の画面座標をクリックします。button は left|right、count 2 はダブルクリックです。{clicked, at:{x,y}} を返しますが、`clicked` はその座標へクリックイベントを POST したという意味で、アプリが処理した確認ではありません。CGEvent には配信確認がないため、ビジー、モーダル、入力無視のアプリでも同じ成功になります。`clicked` を信頼せず ui_wait_for_element または ui_read_tree で効果を確認してください。element_disabled はアプリが AXEnabled=false を公開した場合だけ返ります。AXEnabled 自体を公開しないコントロールは不明扱いでクリックされます。アクセシビリティ権限が必要です。

必須入力

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

権限と確認

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

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の 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": {
      "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 で効果を確認してください。

必須入力

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

権限と確認

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

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の 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": {
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

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