ui_keystroke
Pantalla, ventanas e interfaz · macOS · Windows
Efecto: ejecución. Estado: disponibilidad controlada.
«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.
macOS
Propósito
Envía una combinación de teclas, por ejemplo, "cmd+shift+5", "return", "cmd+," o "escape". Los modificadores admitidos son cmd, shift, alt/option, ctrl y fn; el último token es la tecla. Devuelve {sent, delivery:"posted_not_confirmed"}: `sent` indica que los eventos de teclado se PUBLICARON, NO que la aplicación actuó. CGEvent no confirma la entrega y el efecto puede ser arbitrario, así que compruébalo con ui_get_element o ui_read_tree. Los modificadores se liberan después de la combinación para no interferir con un ui_type posterior. Devuelve unknown_key si no reconoce la tecla. Requiere permiso de accesibilidad.
Entradas obligatorias
keys
Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.
Permisos y confirmación
El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.
- Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.
Esquema técnico canónico en inglés — macOS
{
"properties": {
"keys": {
"description": "e.g. cmd+shift+5, return, cmd+,",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para ui_keystroke. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.
{
"keys": "escape"
}Windows
Propósito
Envía una combinación de teclas, por ejemplo, "ctrl+s", "ctrl+shift+n", "return", "alt+f4" o "escape". Los modificadores admitidos son ctrl, shift, alt y win; cmd también se acepta como alias de ctrl. El último token es la tecla. Devuelve unknown_key si no reconoce la tecla. Pase element_ref para dirigirla a un elemento (al que primero se le da el foco); sin él, las teclas van a la aplicación enfocada, que se informa en sent_to.
Entradas obligatorias
keys
Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.
Permisos y confirmación
El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.
- Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.
Esquema técnico canónico en inglés — 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"
}Ejemplo documental
Ejemplo de documentación para ui_keystroke. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.
{
"keys": "escape"
}