ui_keystroke
Écran, fenêtres et interface · macOS · Windows
Effet: exécution. État: disponibilité conditionnelle.
«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.
macOS
Objectif
Envoie une combinaison de touches, par ex. "cmd+maj+5", "return", "cmd+,", "escape". Modificateurs : cmd, shift, alt/option, ctrl, fn. Le dernier jeton est la clé. Renvoie {sent, delivery:"posted_not_confirmed"} — `sent` signifie que les événements clés ont été PUBLIÉS, PAS que l'application a agi en conséquence : CGEvent ne comporte aucune confirmation delivery et l'effet d'une frappe est arbitraire, donc rien ne peut être relu pour le prouver. Confirmez l'effet avec ui_get_element / ui_read_tree plutôt que de faire confiance à « sent ». Les modificateurs sont libérés après le combo, donc un ui_type suivant n'est pas avalé. unknown_key si la clé n'est pas reconnue. Nécessite une autorisation d’accessibilité.
Entrées requises
keys
Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.
Autorisations et confirmation
Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — macOS
{
"properties": {
"keys": {
"description": "e.g. cmd+shift+5, return, cmd+,",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Exemple documentaire
Exemple de documentation pour ui_keystroke. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{
"keys": "escape"
}Windows
Objectif
Envoie une combinaison de touches, par ex. "ctrl+s", "ctrl+shift+n", "return", "alt+f4", "escape". Modificateurs : ctrl, shift, alt, win (cmd est accepté comme alias pour ctrl). Le dernier jeton est la touche. unknown_key si la touche n'est pas reconnue. Passez element_ref pour viser un élément (qui reçoit d'abord le focus) ; sans lui, les touches vont à l'application qui a le focus, indiquée en retour dans sent_to.
Entrées requises
keys
Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.
Autorisations et confirmation
Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — 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"
}Exemple documentaire
Exemple de documentation pour ui_keystroke. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{
"keys": "escape"
}