QKeyEvent Class
La clase QKeyEvent describe un evento de tecla. Más información...
| Encabezado: | #include <QKeyEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QInputEvent |
- Lista de todos los miembros, incluidos los heredados
- QKeyEvent forma parte de las clases de eventos.
Funciones públicas
| QKeyEvent(QEvent::Type type, int key, Qt::KeyboardModifiers modifiers, const QString &text = QString(), bool autorep = false, quint16 count = 1) | |
| QKeyEvent(QEvent::Type type, int key, Qt::KeyboardModifiers modifiers, quint32 nativeScanCode, quint32 nativeVirtualKey, quint32 nativeModifiers, const QString &text = QString(), bool autorep = false, quint16 count = 1, const QInputDevice *device = QInputDevice::primaryKeyboard()) | |
| int | count() const |
| bool | isAutoRepeat() const |
| int | key() const |
(since 6.0) QKeyCombination | keyCombination() const |
| bool | matches(QKeySequence::StandardKey key) const |
| Qt::KeyboardModifiers | modifiers() const |
| quint32 | nativeModifiers() const |
| quint32 | nativeScanCode() const |
| quint32 | nativeVirtualKey() const |
| QString | text() const |
Funciones protegidas
| QKeyEvent(QKeyEvent &&) | |
| QKeyEvent & | operator=(QKeyEvent &&) |
| QKeyEvent & | operator=(const QKeyEvent &other) |
Descripción detallada
Los eventos de teclas se envían al widget que tiene el foco de entrada del teclado cuando se pulsan o se sueltan las teclas.
Un evento de tecla contiene un indicador de aceptación especial que indica si el receptor gestionará el evento de tecla. Este indicador está activado por defecto para QEvent::KeyPress y QEvent::KeyRelease, por lo que no es necesario llamar a accept() al actuar sobre un evento de tecla. En el caso de QEvent::ShortcutOverride, el receptor debe aceptar explícitamente el evento para activar la anulación. Al llamar a ignore() en un evento de tecla, este se propagará al widget padre. El evento se propaga hacia arriba por la cadena de widgets padres hasta que un widget lo acepte o un filtro de eventos lo consuma.
La función QWidget::setEnabled() puede utilizarse para habilitar o deshabilitar los eventos de ratón y teclado de un widget.
Los controladores de eventos QWidget::keyPressEvent(), QWidget::keyReleaseEvent(), QGraphicsItem::keyPressEvent() y QGraphicsItem::keyReleaseEvent() reciben eventos de teclas.
Véase también QFocusEvent y QWidget::grabKeyboard().
Documentación de las funciones miembro
QKeyEvent::QKeyEvent(QEvent::Type type, int key, Qt::KeyboardModifiers modifiers, const QString &text = QString(), bool autorep = false, quint16 count = 1)
Crea un objeto de evento clave.
El parámetro « type » debe ser « QEvent::KeyPress », « QEvent::KeyRelease » o « QEvent::ShortcutOverride ».
Int key es el código de la Qt::Key que debe detectar el bucle de eventos. Si key es 0, el evento no es el resultado de una tecla conocida; por ejemplo, puede ser el resultado de una secuencia de composición o de una macro de teclado. modifiers contiene los modificadores del teclado, y el valor de text es el texto Unicode generado por la tecla. Si autorep es verdadero, isAutoRepeat() será verdadero. count es el número de teclas implicadas en el evento.
QKeyEvent::QKeyEvent(QEvent::Type type, int key, Qt::KeyboardModifiers modifiers, quint32 nativeScanCode, quint32 nativeVirtualKey, quint32 nativeModifiers, const QString &text = QString(), bool autorep = false, quint16 count = 1, const QInputDevice *device = QInputDevice::primaryKeyboard())
Crea un objeto de evento clave.
El parámetro « type » debe ser « QEvent::KeyPress », « QEvent::KeyRelease » o « QEvent::ShortcutOverride ».
Int key es el código de la Qt::Key que el bucle de eventos debe detectar. Si « key » es 0, el evento no es resultado de una tecla conocida; por ejemplo, puede ser el resultado de una secuencia de composición o de una macro de teclado. « modifiers » contiene los modificadores del teclado, y el « text » proporcionado es el texto Unicode generado por la tecla. Si « autorep » es verdadero, « isAutoRepeat()» será verdadero. « count » es el número de teclas implicadas en el evento.
Además de los datos habituales del evento de tecla, también contiene nativeScanCode, nativeVirtualKey y nativeModifiers. Estos datos adicionales son utilizados por el sistema de atajos para determinar qué atajos deben activarse.
[protected delete] QKeyEvent::QKeyEvent(QKeyEvent &&)
Crea una instancia de ` QKeyEvent`. Esta función se ha eliminado.
int QKeyEvent::count() const
Devuelve el número de claves implicadas en este evento. Si text() no está vacía, se trata simplemente de la longitud de la cadena.
Véase también Qt::WA_KeyCompression.
bool QKeyEvent::isAutoRepeat() const
Devuelve « true » si este evento procede de una tecla con repetición automática; devuelve « false » si procede de una pulsación inicial de la tecla.
Ten en cuenta que, si el evento es un evento comprimido de varias teclas que se debe en parte a la repetición automática, esta función podría devolver «true» o «false» de forma indeterminada.
int QKeyEvent::key() const
Devuelve 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 función text() (que devuelve el texto Unicode generado por la tecla) 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.
Véase también Qt::WA_KeyCompression.
[since 6.0] QKeyCombination QKeyEvent::keyCombination() const
Devuelve un objeto ` QKeyCombination ` que contiene tanto el ` key()` como el ` modifiers()` asociados a este evento.
Esta función se introdujo en Qt 6.0.
bool QKeyEvent::matches(QKeySequence::StandardKey key) const
Devuelve ` true ` si el evento de tecla coincide con el estándar indicado ` key`; en caso contrario, devuelve ` false`.
Qt::KeyboardModifiers QKeyEvent::modifiers() const
Devuelve los indicadores de modificadores del teclado que estaban activos inmediatamente después de que se produjera el evento.
Advertencia: No siempre se puede confiar enesta función. El usuario puede confundirla, por ejemplo, pulsando simultáneamente las teclas Shift y soltando una de ellas.
Véase también ` QGuiApplication::keyboardModifiers()`.
quint32 QKeyEvent::nativeModifiers() const
Devuelve los modificadores nativos de un evento de tecla. Si el evento de tecla no contiene estos datos, se devuelve 0.
Nota: Los modificadores nativos pueden ser 0, incluso si el evento de tecla contiene información ampliada.
quint32 QKeyEvent::nativeScanCode() const
Devuelve el código de escaneo nativo del evento de tecla. Si el evento de tecla no contiene estos datos, se devuelve 0.
Nota: El código de escaneo nativo puede ser 0, incluso si el evento de tecla contiene información ampliada.
quint32 QKeyEvent::nativeVirtualKey() const
Devuelve la tecla virtual nativa o el símbolo de tecla del evento de tecla. Si el evento de tecla no contiene estos datos, se devuelve 0.
Nota: La tecla virtual nativa puede ser 0, incluso si el evento de tecla contiene información ampliada.
QString QKeyEvent::text() const
Devuelve el texto Unicode generado por esta clave.
El texto no se limita al rango imprimible de puntos de código Unicode y puede incluir caracteres de control o caracteres de otras categorías Unicode, como « QChar::Other_PrivateUse ».
El texto también puede estar vacío, por ejemplo, cuando se pulsan teclas modificadoras como Mayús, Control, Alt y Meta (dependiendo de la plataforma). La función key() siempre devolverá un valor válido.
Véase también Qt::WA_KeyCompression.
[protected delete] QKeyEvent &QKeyEvent::operator=(QKeyEvent &&)
Asigna mediante «move» other a esta instancia de QKeyEvent. Esta función se elimina.
[noexcept protected default] QKeyEvent &QKeyEvent::operator=(const QKeyEvent &other)
Asigna mediante copia el objeto « other » a esta instancia de « QKeyEvent ».
© 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.