Alle Werkzeuge

ui_click

Bildschirm, Fenster und Oberfläche · macOS · Windows

Wirkung: Ausführen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Klickt auf ein Element (by element_ref, in der Mitte) oder eine Bildschirmkoordinate (by-Koordinaten). Schaltfläche left|right, Anzahl 2 = Doppelklick. Gibt {clicked, at:{x,y}} zurück – „clicked“ bedeutet, dass das Klickereignis POSTED an diesen Koordinaten war, NOT, dass die App darauf reagiert hat: CGEvent trägt keine Delivery-Bestätigung, also einen Busy, modale oder eingabeignorierende App-Berichte exactly der gleiche Erfolg. Bestätigen Sie den Effekt mit ui_wait_for_element oder ui_read_tree, anstatt „clicked“ zu vertrauen. element_disabled wird zurückgegeben ONLY, wenn die App tatsächlich y veröffentlicht AXEnabled=false; Ein Steuerelement, das AXEnabled überhaupt nicht veröffentlicht, wird als unbekannt und clicked behandelt. Erfordert die Accessibility-Berechtigung.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für ui_click. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows

Zweck

Klickt auf ein Element (by element_ref, in seiner Mitte) oder eine Bildschirmkoordinate (by-Koordinaten). Schaltfläche left|right, Anzahl 2 = Doppelklick. Gibt {clicked, at:{x,y}} zurück – „clicked“ bedeutet, dass der Klick an diesen Koordinaten POSTED war, NOT, dass die App darauf reagiert hat: SendInput trägt keine Delivery-Bestätigung, daher meldet eine Busy- oder modale App den gleichen Erfolg. Bestätigen Sie den Effekt mit ui_wait_for_element oder ui_read_tree, anstatt „clicked“ zu vertrauen.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für ui_click. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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