ui_find_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

GUI-automatisering — bestuur de interface van een native app. Vindt een element (knop, veld, menu…) in de toegankelijkheidsstructuur van een app op basis van rol en/of label. Beperk het bereik met app_bundle_id of window_id. Retourneert een ondoorzichtige element_ref (in deze sessie bruikbaar door ui_click / ui_get_element), plus rol, label, grenzen, focusstatus en alleen `enabled` wanneer de app AXEnabled publiceert (anders `enabled_unknown: true`, wat NIET uitgeschakeld betekent). found=false wanneer de app bereikbaar is maar geen enkel element overeenkomt; app_not_found is een expliciete fout. 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": {
    "app_bundle_id": {
      "description": "Scope the search to this app.",
      "type": "string"
    },
    "index": {
      "description": "Which match to return if several (default 0).",
      "type": "integer"
    },
    "label": {
      "description": "AX title/description to match.",
      "type": "string"
    },
    "match": {
      "description": "Default contains.",
      "enum": [
        "exact",
        "contains"
      ],
      "type": "string"
    },
    "role": {
      "description": "AX role, e.g. AXButton, AXMenuItem, AXTextField.",
      "type": "string"
    },
    "window_id": {
      "description": "Alternatively scope by a window_id from list_windows.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Documentatievoorbeeld

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

{
  "label": "Save"
}

Windows

Doel

GUI-automatisering — bestuur de interface van een native Windows-app. Vindt een element (knop, veld, menu…) in de UI Automation-structuur van een app op basis van rol en/of label. Beperk het bereik met `app` (een procesnaam zoals "notepad", of een deel van een venstertitel). Retourneert een ondoorzichtige element_ref (in deze sessie bruikbaar door ui_click / ui_type / ui_get_element), plus rol, label, grenzen, ingeschakelde status en focusstatus. `role` is een UIA-besturingstype (Button, Edit, CheckBox, MenuItem, Hyperlink, Text…) — voer ui_read_tree uit om de exacte namen te zien. found=false wanneer de app bereikbaar is maar niets overeenkomt; app_not_found is een expliciete fout.

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": {
    "app": {
      "description": "Scope to this app: process name (e.g. notepad) or a window-title substring.",
      "type": "string"
    },
    "index": {
      "description": "Which match to return if several (default 0).",
      "type": "integer"
    },
    "label": {
      "description": "Name/HelpText/Value to match.",
      "type": "string"
    },
    "match": {
      "description": "Default contains.",
      "enum": [
        "exact",
        "contains"
      ],
      "type": "string"
    },
    "role": {
      "description": "UIA control type, e.g. Button, Edit, MenuItem, CheckBox.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Documentatievoorbeeld

{
  "label": "Save"
}