ui_get_element

Schermo, finestre e interfaccia · macOS · Windows

Effetto: lettura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Risolve nuovamente un element_ref restituito in precedenza (i suoi limiti o il suo stato potrebbero essere cambiati). Restituisce ruolo, etichetta, limiti, stato attivo, valore ed `enabled` SOLO quando l’app pubblica AXEnabled: questo attributo è facoltativo, quindi molti controlli perfettamente utilizzabili lo omettono (come l’area di testo di TextEdit). Quando manca, viene restituito invece `enabled_unknown: true`: significa “sconosciuto”, NON disabilitato, e ui_click eseguirà il clic. stale_element indica che l’handle è sconosciuto o che l’elemento non esiste più.

Input obbligatori

element_ref

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — macOS

{
  "properties": {
    "element_ref": {
      "type": "string"
    }
  },
  "required": [
    "element_ref"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per ui_get_element. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows