Tutti gli strumenti

ui_read_tree

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

Restituisce un albero di accessibilità COMPATTO degli elementi etichettati e interattivi di un’app nativa in esecuzione (pulsanti, link, campi di testo, caselle di controllo, menu…): è l’equivalente nativo della modalità a11y di web_read. Usalo per SCOPRIRE su cosa agire in un’app sconosciuta quando non conosci già il ruolo o l’etichetta di un elemento (ui_find_element ne richiede uno in anticipo). Ogni nodo interattivo contiene un `ref` che puoi passare direttamente a ui_click. Passa app_bundle_id di un’app in esecuzione (per esempio com.apple.finder; consulta list_windows); l’albero viene ridotto ai nodi che contengono segnali ed è limitato da max_depth (valore predefinito 12) e da un budget di nodi, quindi per finestre molto grandi viene restituito solo in parte. Per impostazione predefinita la barra dei menu macOS dell’app viene omessa (contiene centinaia di nodi di voci di menu): passa include_menu_bar=true se devi agire specificamente sulle sue voci.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

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.

Schema tecnico canonico in inglese — macOS
{
  "properties": {
    "app_bundle_id": {
      "description": "Bundle id of a RUNNING app (e.g. com.apple.finder)",
      "type": "string"
    },
    "include_menu_bar": {
      "description": "Include the app's macOS menu bar (hundreds of menu-item nodes). Default false.",
      "type": "boolean"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20)",
      "type": "integer"
    },
    "window_id": {
      "description": "Alternative to app_bundle_id: a window id from list_windows (targets that window's app)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per ui_read_tree. 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.

{}

Windows

Scopo

Restituisce un albero UI Automation COMPATTO degli elementi etichettati e interattivi di un’app Windows in esecuzione (pulsanti, link, campi di modifica, caselle di controllo, menu…): è l’equivalente nativo della modalità a11y di web_read. Usalo per SCOPRIRE su cosa agire in un’app sconosciuta quando non conosci già il ruolo o l’etichetta di un elemento (ui_find_element ne richiede uno in anticipo). Ogni nodo interattivo contiene un `ref` che puoi passare direttamente a ui_click. Passa `app` (il nome del processo di un’app in esecuzione, per esempio notepad). L’albero viene ridotto ai nodi che contengono segnali ed è limitato da max_depth (valore predefinito 12) e da un budget di nodi, quindi per finestre molto grandi viene restituito solo in parte.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

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.

Schema tecnico canonico in inglese — Windows
{
  "properties": {
    "app": {
      "description": "Process name of a RUNNING app (e.g. notepad).",
      "type": "string"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per ui_read_tree. 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.

{}