ui_get_element

Scherm, vensters en interface · macOS · Windows

Effect: lezen. 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

Zoekt een eerder geretourneerde element_ref opnieuw op (de grenzen of status ervan kunnen zijn gewijzigd). Retourneert rol, label, grenzen, focusstatus, waarde en ALLEEN `enabled` wanneer de app AXEnabled publiceert — dat kenmerk is optioneel, waardoor veel volledig bruikbare besturingselementen het weglaten (zoals het tekstgebied van TextEdit). Wanneer het ontbreekt, krijg je in plaats daarvan `enabled_unknown: true`; dat betekent 'onbekend', NIET uitgeschakeld, en ui_click zal erop klikken. stale_element wordt geretourneerd als de handle onbekend is of het element niet meer bestaat.

Vereiste invoer

element_ref

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

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": {
    "element_ref": {
      "type": "string"
    }
  },
  "required": [
    "element_ref"
  ],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor ui_get_element. 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.

{
  "element_ref": "demo-button-001"
}

Windows