ui_type

Schermo, finestre e interfaccia · macOS · Windows

Effetto: esecuzione. Stato: disponibilità condizionata.

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

macOS

Scopo

Digita testo nel controllo attivo, oppure mette prima a fuoco element_ref e poi digita. Invia eventi di tastiera reali, così vengono eseguiti convalide e gestori. Il risultato viene VERIFICATO RILEGGENDO il controllo, non soltanto osservando il successo della scrittura: {typed, verified:true} indica che il valore è effettivamente cambiato. input_not_applied è un errore esplicito: gli eventi sono stati inviati ma il valore NON è cambiato, quindi non è stato digitato nulla, di solito perché la finestra non era in primo piano. verified:false con verification:'unavailable' indica che il controllo non pubblica un valore leggibile; la consegna non può essere confermata e va riletta direttamente. Richiede l’autorizzazione Accessibility.

Input obbligatori

text

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": {
      "description": "Optional; focus this element first.",
      "type": "string"
    },
    "text": {
      "description": "The text to type.",
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

Esempio documentale

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

{
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows