Keys QML Type (Uncreatable)
Proporciona la gestión de claves a los elementos. Más...
| Import Statement: | import QtQuick |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades
Señales
- asteriskPressed(KeyEvent event)
- backPressed(KeyEvent event)
- backtabPressed(KeyEvent event)
- callPressed(KeyEvent event)
- cancelPressed(KeyEvent event)
- context1Pressed(KeyEvent event)
- context2Pressed(KeyEvent event)
- context3Pressed(KeyEvent event)
- context4Pressed(KeyEvent event)
- deletePressed(KeyEvent event)
- digit0Pressed(KeyEvent event)
- digit1Pressed(KeyEvent event)
- digit2Pressed(KeyEvent event)
- digit3Pressed(KeyEvent event)
- digit4Pressed(KeyEvent event)
- digit5Pressed(KeyEvent event)
- digit6Pressed(KeyEvent event)
- digit7Pressed(KeyEvent event)
- digit8Pressed(KeyEvent event)
- digit9Pressed(KeyEvent event)
- downPressed(KeyEvent event)
- enterPressed(KeyEvent event)
- escapePressed(KeyEvent event)
- flipPressed(KeyEvent event)
- hangupPressed(KeyEvent event)
- leftPressed(KeyEvent event)
- menuPressed(KeyEvent event)
- noPressed(KeyEvent event)
- pressed(KeyEvent event)
- released(KeyEvent event)
- returnPressed(KeyEvent event)
- rightPressed(KeyEvent event)
- selectPressed(KeyEvent event)
- shortcutOverride(KeyEvent event)
- spacePressed(KeyEvent event)
- tabPressed(KeyEvent event)
- upPressed(KeyEvent event)
- volumeDownPressed(KeyEvent event)
- volumeUpPressed(KeyEvent event)
- yesPressed(KeyEvent event)
Descripción detallada
Todas las primitivas visuales admiten la gestión de teclas a través del tipo de conexión «Keys». Las teclas se pueden gestionar mediante las propiedades de señal «onPressed» y «onReleased».
Las propiedades de señal tienen un parámetro « KeyEvent » denominado «event», que contiene los detalles del evento. Si se gestiona una tecla, se debe establecer «event.accepted» en «true» para evitar que el evento se propague hacia arriba en la jerarquía de elementos.
Ejemplo de uso
El siguiente ejemplo muestra cómo se puede utilizar el controlador general «onPressed» para detectar una tecla concreta; en este caso, la tecla de cursor izquierda:
Item {
anchors.fill: parent
focus: true
Keys.onPressed: (event)=> {
if (event.key == Qt.Key_Left) {
console.log("move left");
event.accepted = true;
}
}
}Algunas teclas también pueden gestionarse mediante propiedades de señal específicas, por ejemplo, «onSelectPressed». Estos controladores establecen automáticamente «event.accepted » en «true».
Item {
anchors.fill: parent
focus: true
Keys.onLeftPressed: console.log("move left")
}Consulte Qt.Key para ver la lista de códigos de teclado.
Prioridades de gestión de teclas
El tipo de conexión de las teclas se puede configurar para gestionar los eventos de tecla antes o después del elemento al que están asociadas. Esto permite interceptar eventos para anular el comportamiento predeterminado de un elemento o actuar como alternativa para las teclas que no gestiona dicho elemento.
Si priority es Keys.BeforeItem (valor por defecto), el orden de procesamiento de los eventos de teclas es:
- Elementos especificados en
forwardTo - manejadores de teclas específicos, p. ej., onReturnPressed
- onPressed, onReleased
- Manejo de teclas específico del elemento, p. ej., el manejo de teclas de ` TextInput `
- el elemento padre
Si la prioridad es «Keys.AfterItem», el orden de procesamiento de los eventos de tecla es:
- Manejo de teclas específico del elemento, p. ej., manejo de teclas « TextInput »
- Elementos especificados en
forwardTo - manejadores de teclas específicos, p. ej., onReturnPressed
- manejadores onPressed y onReleased
- elemento padre
Si el evento se acepta durante cualquiera de los pasos anteriores, la propagación de la tecla se detiene.
Véase también KeyEvent y KeyNavigation attached property.
Documentación de propiedades
enabled : bool
Este indicador habilita el manejo de claves si su valor es «true» (por defecto); en caso contrario, no se llamará a ningún manejador de claves.
forwardTo : list<Item> [read-only]
Esta propiedad permite reenviar a otros elementos las pulsaciones de teclas, las sueltas de teclas y las entradas de teclado procedentes de métodos de entrada. Esto puede resultar útil cuando se desea que un elemento gestione determinadas teclas (por ejemplo, las teclas de flecha arriba y abajo) y que otro elemento gestione otras teclas (por ejemplo, las teclas de flecha izquierda y derecha). Una vez que un elemento al que se le han reenviado las pulsaciones de teclas acepta el evento, este ya no se reenvía a los elementos posteriores de la lista.
Este ejemplo reenvía eventos de teclas a dos listas:
Item {
ListView {
id: list1
// ...
}
ListView {
id: list2
// ...
}
Keys.forwardTo: [list1, list2]
focus: true
}Para ver el orden en el que se reciben los eventos al utilizar forwardTo, consulta Key Handling Priorities.
priority : enumeration
Esta propiedad determina si las claves se procesan antes o después de que el propio elemento adjunto gestione sus claves.
| Constante | Descripción |
|---|---|
Keys.BeforeItem | (por defecto) procesa los eventos de tecla antes del procesamiento normal de teclas del elemento. Si se acepta el evento, no se transmitirá al elemento. |
Keys.AfterItem | Procesa los eventos de teclas después del procesamiento normal de teclas del elemento. Si el elemento acepta el evento de tecla, este no será gestionado por el controlador de la propiedad «Keys attached». |
Véase también Key Handling Priorities.
Documentación de Signal
asteriskPressed(KeyEvent event)
Esta señal se emite cuando se pulsa el asterisco «*». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onAsteriskPressed.
backPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Atrás». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onBackPressed.
backtabPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la combinación de teclas Mayús+Tab (Backtab). El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onBacktabPressed.
callPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Llamar». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onCallPressed.
cancelPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Cancelar». El parámetro « event » proporciona información sobre el evento.
Nota: El controlador correspondiente es onCancelPressed.
context1Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla Context1. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onContext1Pressed.
context2Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla Context2. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onContext2Pressed.
context3Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla Context3. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onContext3Pressed.
context4Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla Context4. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onContext4Pressed.
deletePressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Suprimir». El parámetro « event » proporciona información sobre el evento.
Nota: El controlador correspondiente es onDeletePressed.
digit0Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «0». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit0Pressed.
digit1Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «1». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit1Pressed.
digit2Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «2». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit2Pressed.
digit3Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «3». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit3Pressed.
digit4Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «4». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit4Pressed.
digit5Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «5». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit5Pressed.
digit6Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «6». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit6Pressed.
digit7Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «7». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es ` onDigit7Pressed`.
digit8Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «8». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit8Pressed.
digit9Pressed(KeyEvent event)
Esta señal se emite cuando se pulsa el dígito «9». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDigit9Pressed.
downPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la flecha hacia abajo. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onDownPressed.
enterPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla Intro. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onEnterPressed.
escapePressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla Escape. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onEscapePressed.
flipPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Flip». El parámetro « event » proporciona información sobre el evento.
Nota: El controlador correspondiente es « onFlipPressed ».
hangupPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla de colgar. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onHangupPressed.
leftPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la flecha de la izquierda. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onLeftPressed.
menuPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Menú». El parámetro « event » proporciona información sobre el evento.
Nota: El controlador correspondiente es onMenuPressed.
noPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «No». El parámetro « event » proporciona información sobre el evento.
Nota: El controlador correspondiente es onNoPressed.
pressed(KeyEvent event)
Esta señal se emite cuando se pulsa una tecla. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es ` onPressed`.
released(KeyEvent event)
Esta señal se emite cuando se suelta una tecla. El parámetro ` event ` proporciona información sobre el evento.
Nota: El controlador correspondiente es onReleased.
returnPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Intro». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onReturnPressed.
rightPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la flecha derecha. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onRightPressed.
selectPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Select». El parámetro « event » proporciona información sobre el evento.
Nota: El controlador correspondiente es onSelectPressed.
shortcutOverride(KeyEvent event)
Esta señal se emite cuando se pulsa una tecla que podría utilizarse como atajo. El parámetro « event » proporciona información sobre el evento.
Establece ` event.accepted ` en ` true ` si deseas evitar que la tecla pulsada se utilice como atajo por otros tipos, como ` Shortcut`. Por ejemplo:
Item {
id: escapeItem
focus: true
// Ensure that we get escape key press events first.
Keys.onShortcutOverride: (event)=> event.accepted = (event.key === Qt.Key_Escape)
Keys.onEscapePressed: {
console.log("escapeItem is handling escape");
// event.accepted is set to true by default for the specific key handlers
}
}
Shortcut {
sequence: "Escape"
onActivated: console.log("Shortcut is handling escape")
}Al igual que con las demás señales, shortcutOverride solo se emitirá para un elemento si dicho elemento tiene activeFocus.
Nota: El controlador correspondiente es onShortcutOverride.
Véase también Shortcut.
spacePressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla Espacio. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onSpacePressed.
tabPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla Tab. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onTabPressed.
upPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la flecha arriba. El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onUpPressed.
volumeDownPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Volumen abajo». El parámetro « event » proporciona información sobre el evento.
Nota: El controlador correspondiente es onVolumeDownPressed.
volumeUpPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Volumen arriba». El parámetro « event » proporciona información sobre el evento.
Nota: El controlador correspondiente es onVolumeUpPressed.
yesPressed(KeyEvent event)
Esta señal se emite cuando se pulsa la tecla «Sí». El parámetro event proporciona información sobre el evento.
Nota: El controlador correspondiente es onYesPressed.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.