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 ein Element (über element_ref, in seiner Mitte) oder eine Bildschirmkoordinate (über coords). button left|right, count 2 = Doppelklick. Gibt {clicked, at:{x,y}} zurück – `clicked` bedeutet, dass das Klickereignis an diesen Koordinaten GESENDET wurde, NICHT, dass die App darauf reagiert hat: CGEvent liefert keine Zustellbestätigung, sodass eine beschäftigte, modale oder Eingaben ignorierende App genau denselben Erfolg meldet. Prüfen Sie die Wirkung mit ui_wait_for_element oder ui_read_tree, statt `clicked` zu vertrauen. element_disabled wird NUR zurückgegeben, wenn die App tatsächlich AXEnabled=false veröffentlicht; ein Steuerelement, das AXEnabled gar nicht veröffentlicht, gilt als unbekannt und wird geklickt. Ein Element, das keine Position veröffentlicht (manche Steuerelemente in Webseiten), wird in den sichtbaren Bereich gescrollt; hat es danach immer noch keine, erfolgt ein einzelner Linksklick über seine Bedienungshilfen-Aktion „press“ und die Antwort lautet {clicked, via:"press_action"} ohne `at`; wird auch das abgelehnt, lautet der Fehler no_bounds – verwenden Sie dann Koordinaten aus einem Screenshot. Erfordert die Berechtigung „Bedienungshilfen“.

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.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

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": {
      "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"
}

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 gepostet wurde, nicht, 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.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

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": {
      "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"
}

Dokumentationsbeispiel

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