ui_find_element

Bildschirm, Fenster und Oberfläche · macOS · Windows

Wirkung: Lesen. 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

GUI-Automatisierung – Steuern Sie die Benutzeroberfläche einer nativen App. Sucht ein Element (Schaltfläche, Feld, Menü …) im Barrierefreiheitsbaum einer App nach Rolle und/oder Bezeichnung. Zielfernrohr mit app_bundle_id oder window_id. Gibt ein undurchsichtiges element_ref (verwendbar von ui_click / ui_get_element in dieser Sitzung) plus Rolle, Bezeichnung, Grenzen, Fokus und „enabled“ nur zurück, wenn die App AXEnabled veröffentlicht (andernfalls „enabled_unknown: true“, was bedeutet, dass NOT deaktiviert ist). found=false, wenn die App erreichbar ist, aber kein Element übereinstimmt; app_not_found ist ein expliziter Fehler. Erfordert die Berechtigung „Barrierefreiheit“.

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

Dokumentationsbeispiel

Dokumentationsbeispiel für ui_find_element. 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.

{
  "label": "Save"
}

Windows

Zweck

GUI-Automatisierung – Steuern Sie die native Windows-app-Schnittstelle. Sucht ein Element (Schaltfläche, Feld, Menü …) im UI-Automatisierungsbaum eines app nach role und/oder Beschriftung. Bereich mit „app“ (Prozessname wie „Notepad“ oder ein Fenstertitel-Teilstring). Gibt ein undurchsichtiges element_ref (verwendbar von ui_click / ui_type / ui_get_element in dieser Sitzung) plus role, Beschriftung, Grenzen, aktiviert, fokussiert zurück. „role“ ist ein UIA-Steuerelementtyp (Button, Edit, CheckBox, MenuItem, Hyperlink, Text…) – führen Sie ui_read_tree aus, um die genauen Namen anzuzeigen. found=false, wenn app erreichbar ist, aber nichts übereinstimmt; app_not_found ist ein expliziter Fehler.

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

Dokumentationsbeispiel

{
  "label": "Save"
}