ui_get_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

Löst ein zuvor zurückgegebenes element_ref erneut auf (seine Grenzen/seinen Status haben sich möglicherweise geändert). Gibt Rolle, Beschriftung, Grenzen, Fokus, Wert und „enabled“ ONLY zurück, wenn die App AXEnabled veröffentlicht – dieses Attribut ist optional, daher wird es in vielen perfekt verwendbaren Steuerelementen weggelassen (im Textbereich von TextEdit ist dies der Fall). Wenn es fehlt, erhalten Sie stattdessen „enabled_unknown: true“; das ist „unbekannt“, NOT deaktiviert und ui_click klickt darauf. stale_element, wenn das Handle unbekannt ist oder das Element nicht mehr vorhanden ist.

Erforderliche Eingaben

element_ref

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

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

Dokumentationsbeispiel

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

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

Windows