KeyEvent QML Type (Uncreatable)
Proporciona información sobre un evento clave. Más...
| Import Statement: | import QtQuick |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades
- accepted : bool
- count : int
- isAutoRepeat : bool
- key : int
- modifiers : int
- nativeScanCode : quint32
- text : string
Métodos
- bool matches(StandardKey matchKey)
Descripción detallada
Por ejemplo, el siguiente código cambia la propiedad «state» del elemento cuando se pulsa la tecla Intro:
Item {
focus: true
Keys.onPressed: (event)=> { if (event.key == Qt.Key_Enter) state = 'ShowDetails'; }
}Documentación de la propiedad
accepted : bool
Al establecer ` accepted ` en «true», se evita que el evento de tecla se propague al elemento padre.
Por lo general, si el elemento reacciona ante el evento de tecla, este debe aceptarse para que los elementos antecesores no respondan también al mismo evento.
count : int [read-only]
Esta propiedad contiene el número de claves implicadas en este evento. Si « KeyEvent::text » no está vacío, se trata simplemente de la longitud de la cadena.
isAutoRepeat : bool [read-only]
Esta propiedad se mantiene independientemente de si este evento procede de una tecla de repetición automática.
key : int [read-only]
Esta propiedad contiene el código de la tecla que se ha pulsado o soltado.
Consulte Qt.Key para ver la lista de códigos de teclado. Estos códigos son independientes del sistema de ventanas subyacente. Tenga en cuenta que esta función no distingue entre mayúsculas y minúsculas; utilice la propiedad text para este fin.
Un valor de 0 o de Qt.Key_Unknown significa que el evento no es el resultado de una tecla conocida; por ejemplo, puede ser el resultado de una secuencia de composición, una macro de teclado o deberse a la compresión de eventos de teclas.
modifiers : int [read-only]
Esta propiedad contiene los indicadores de modificadores del teclado que existían justo antes de que se produjera el evento.
Contiene una combinación bit a bit de valores numéricos (igual que en ` Qt::KeyboardModifier`):
| Constante | Descripción |
|---|---|
Qt.NoModifier | No hay ninguna tecla modificadora pulsada. |
Qt.ShiftModifier | Se ha pulsado una tecla Mayús del teclado. |
Qt.ControlModifier | Se pulsa la tecla Ctrl del teclado. |
Qt.AltModifier | Se pulsa la tecla Alt del teclado. |
Qt.MetaModifier | Se pulsa la tecla Meta del teclado. |
Qt.KeypadModifier | Se ha pulsado una tecla del teclado numérico. |
Qt.GroupSwitchModifier | Solo en X11. Se pulsa una tecla Mode_switch del teclado. |
Por ejemplo, para reaccionar ante una combinación de teclas Mayús + Intro:
Item {
focus: true
Keys.onPressed: (event)=> {
if ((event.key == Qt.Key_Enter) && (event.modifiers & Qt.ShiftModifier))
doSomething();
}
}nativeScanCode : quint32 [read-only]
Esta propiedad contiene el código de escaneo nativo de la tecla que se ha pulsado. Se transmite desde QKeyEvent sin modificaciones.
Véase también QKeyEvent::nativeScanCode().
text : string [read-only]
Esta propiedad contiene el texto Unicode generado por la tecla. El texto devuelto puede ser una cadena vacía en los casos en que se pulsen o se suelten teclas modificadoras, como Shift, Control, Alt y Meta. En tales casos, « key » contendrá un valor válido
Documentación del método
bool matches(StandardKey matchKey)
Devuelve true si el evento de tecla coincide con el estándar indicado matchKey; en caso contrario, devuelve false.
Item {
focus: true
Keys.onPressed: (event)=> {
if (event.matches(StandardKey.Undo))
myModel.undo();
else if (event.matches(StandardKey.Redo))
myModel.redo();
}
}Véase también QKeySequence::StandardKey.
© 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.