ui_click

Scherm, vensters en interface · macOS · Windows

Effect: uitvoeren. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Klikt op een element (via element_ref, in het midden ervan) of op een schermcoördinaat (via coords). button is left|right; count 2 betekent dubbelklikken. Retourneert {clicked, at:{x,y}} — `clicked` betekent dat de klikgebeurtenis op die coördinaten is POSTED, NIET dat de app erop heeft gereageerd: CGEvent geeft geen bevestiging van aflevering, waardoor een bezette, modale of invoer negerende app precies hetzelfde succes rapporteert. Bevestig het effect met ui_wait_for_element of ui_read_tree in plaats van op `clicked` te vertrouwen. element_disabled wordt ALLEEN geretourneerd wanneer de app daadwerkelijk AXEnabled=false publiceert; een besturingselement dat AXEnabled helemaal niet publiceert, wordt als onbekend behandeld en aangeklikt. Vereist Accessibility-toestemming.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor ui_click. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows