ui_keystroke
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
Invia una combinazione di tasti, per esempio "cmd+shift+5", "return", "cmd+,", "escape". Modificatori: cmd, shift, alt/option, ctrl, fn. L’ultimo token è il tasto. Restituisce {sent, delivery:"posted_not_confirmed"}: `sent` significa che gli eventi di tastiera sono stati PUBBLICATI, NON che l’app abbia agito di conseguenza; CGEvent non fornisce alcuna conferma della consegna e l’effetto di una pressione di tasto è arbitrario, quindi non è possibile rileggere nulla che lo dimostri. Conferma l’effetto con ui_get_element / ui_read_tree invece di fidarti di `sent`. I modificatori vengono rilasciati dopo la combinazione, così un successivo ui_type non viene assorbito. unknown_key indica che il tasto non è riconosciuto. Richiede l’autorizzazione Accessibilità.
Input obbligatori
keys
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": {
"keys": {
"description": "e.g. cmd+shift+5, return, cmd+,",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Esempio documentale
Esempio di documentazione per ui_keystroke. 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.
{
"keys": "escape"
}Windows
Scopo
Invia una combinazione di tasti, ad es. "ctrl+s", "ctrl+shift+n", "return", "alt+f4", "escape". Modificatori: ctrl, shift, alt, win (cmd è accettato come alias di ctrl). L'ultimo token è il tasto. unknown_key se il tasto non viene riconosciuto. Passa element_ref per puntare a un elemento (che riceve prima il focus); senza di esso i tasti vanno all'app con il focus, riportata in sent_to.
Input obbligatori
keys
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 — Windows
{
"properties": {
"element_ref": {
"description": "Optional. Focus this element (from ui_find_element) before sending; refused with focus_failed, nothing sent, if the focus does not land in its app or its app is not the window in front; focus_lost (with sent_to and target) when another window was in front after the keys. Without it the keys go to whatever has the focus — check sent_to.",
"type": "string"
},
"keys": {
"description": "e.g. ctrl+s, return, ctrl+shift+n",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Esempio documentale
Esempio di documentazione per ui_keystroke. 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.
{
"keys": "escape"
}