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) of op een schermcoördinaat (via coords). button left|right, count 2 = dubbelklik. Geeft {clicked, at:{x,y}} terug — `clicked` betekent dat de klikgebeurtenis op die coördinaten is VERZONDEN, NIET dat de app erop heeft gereageerd: CGEvent geeft geen bevestiging van aflevering, dus een drukke app, een modaal venster of een app die invoer negeert meldt exact hetzelfde succes. Controleer het effect met ui_wait_for_element of ui_read_tree in plaats van `clicked` te vertrouwen. element_disabled wordt ALLEEN teruggegeven als de app daadwerkelijk AXEnabled=false publiceert; een bedieningselement dat AXEnabled helemaal niet publiceert, geldt als onbekend en wordt aangeklikt. Een element dat geen positie publiceert (sommige bedieningselementen in webpagina's) wordt in beeld gescrold; heeft het er dan nog steeds geen, dan wordt één enkele linkerklik gedaan via de toegankelijkheidsactie press en is het antwoord {clicked, via:"press_action"} zonder `at`; wordt ook dat geweigerd, dan is de fout no_bounds — gebruik coords uit een schermafbeelding. Vereist de machtiging Toegankelijkheid.

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

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

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 klik op die coördinaten is VERSTUURD, NIET dat de app erop heeft gereageerd: SendInput geeft geen bevestiging van aflevering, waardoor een bezette of modale app hetzelfde succes rapporteert. Bevestig het effect met ui_wait_for_element of ui_read_tree in plaats van op `clicked` te vertrouwen.

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 — 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"
}

Documentatievoorbeeld

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