QKeySequenceEdit Class
El widget QKeySequenceEdit permite introducir una secuencia de teclas ( QKeySequence). Más información...
| Encabezado: | #include <QKeySequenceEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QWidget |
Propiedades
(since 6.4)clearButtonEnabled : bool(since 6.5)finishingKeyCombinations : QList<QKeyCombination>- keySequence : QKeySequence
(since 6.5)maximumSequenceLength : qsizetype
Funciones públicas
| QKeySequenceEdit(QWidget *parent = nullptr) | |
| QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr) | |
| virtual | ~QKeySequenceEdit() |
| QList<QKeyCombination> | finishingKeyCombinations() const |
| bool | isClearButtonEnabled() const |
| QKeySequence | keySequence() const |
| qsizetype | maximumSequenceLength() const |
| void | setClearButtonEnabled(bool enable) |
| void | setFinishingKeyCombinations(const QList<QKeyCombination> &finishingKeyCombinations) |
Ranuras públicas
| void | clear() |
| void | setKeySequence(const QKeySequence &keySequence) |
| void | setMaximumSequenceLength(qsizetype count) |
Señales
| void | editingFinished() |
| void | keySequenceChanged(const QKeySequence &keySequence) |
Funciones protegidas reimplementadas
| virtual bool | event(QEvent *e) override |
| virtual void | focusOutEvent(QFocusEvent *e) override |
| virtual void | keyPressEvent(QKeyEvent *e) override |
| virtual void | keyReleaseEvent(QKeyEvent *e) override |
| virtual void | timerEvent(QTimerEvent *e) override |
Descripción detallada
Este widget permite al usuario seleccionar una « QKeySequence », que suele utilizarse como atajo. La grabación se inicia cuando el widget recibe el foco y finaliza un segundo después de que el usuario suelte la última tecla.
Véase también QKeySequenceEdit::keySequence.
Documentación de propiedades
[since 6.4] clearButtonEnabled : bool
Esta propiedad determina si el campo de edición de secuencia de teclas muestra un botón de borrado cuando no está vacío.
Si está habilitada, el campo de edición de secuencia de teclas muestra un botón «Borrar» al final cuando contiene texto; de lo contrario, el campo de edición no muestra dicho botón (valor por defecto).
Esta enumeración se introdujo en Qt 6.4.
Funciones de acceso:
| bool | isClearButtonEnabled() const |
| void | setClearButtonEnabled(bool enable) |
[since 6.5] finishingKeyCombinations : QList<QKeyCombination>
Esta propiedad contiene la lista de combinaciones de teclas que finalizan la edición de las secuencias de teclas.
Cualquier combinación de la lista finalizará la edición de las secuencias de teclas. El resto de combinaciones de teclas se pueden grabar como parte de una secuencia de teclas. Por defecto, « Qt::Key_Tab » y « Qt::Key_Backtab » finalizarán la grabación de la secuencia de teclas.
Esta enumeración se introdujo en Qt 6.5.
Funciones de acceso:
| QList<QKeyCombination> | finishingKeyCombinations() const |
| void | setFinishingKeyCombinations(const QList<QKeyCombination> &finishingKeyCombinations) |
keySequence : QKeySequence
Esta propiedad contiene la secuencia de teclas seleccionada actualmente.
El atajo de teclado puede modificarse por parte del usuario o mediante una función setter.
Nota: Si la propiedad « QKeySequence » es más larga que la propiedad « maximumSequenceLength », la secuencia de teclas se trunca.
Funciones de acceso:
| QKeySequence | keySequence() const |
| void | setKeySequence(const QKeySequence &keySequence) |
Señal de notificación:
| void | keySequenceChanged(const QKeySequence &keySequence) |
[since 6.5] maximumSequenceLength : qsizetype
Esta propiedad indica la longitud máxima de la secuencia.
El número máximo de secuencias de teclas que un usuario puede introducir. El valor debe estar comprendido entre 1 y 4, siendo 4 el valor predeterminado.
Esta enumeración se introdujo en Qt 6.5.
Funciones de acceso:
| qsizetype | maximumSequenceLength() const |
| void | setMaximumSequenceLength(qsizetype count) |
Documentación de las funciones miembro
[explicit] QKeySequenceEdit::QKeySequenceEdit(QWidget *parent = nullptr)
Crea un widget `QKeySequenceEdit` con el ` parent` especificado.
[explicit] QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr)
Crea un widget `QKeySequenceEdit` con los valores ` keySequence ` y ` parent` indicados.
[virtual noexcept] QKeySequenceEdit::~QKeySequenceEdit()
Elimina el objeto « QKeySequenceEdit ».
[slot] void QKeySequenceEdit::clear()
Borra la secuencia de teclas actual.
[signal] void QKeySequenceEdit::editingFinished()
Esta señal se emite cuando el usuario termina de introducir el atajo.
Nota: hay un retraso de un segundo entre el momento en que se suelta la última tecla y el momento en que se emite esta señal.
[override virtual protected] bool QKeySequenceEdit::event(QEvent *e)
Reimplementa: ` QWidget::event(QEvent *event)`.
[override virtual protected] void QKeySequenceEdit::focusOutEvent(QFocusEvent *e)
Reimplementa: ` QWidget::focusOutEvent(QFocusEvent *event)`.
[override virtual protected] void QKeySequenceEdit::keyPressEvent(QKeyEvent *e)
Reimplementa: ` QWidget::keyPressEvent(QKeyEvent *event)`.
[override virtual protected] void QKeySequenceEdit::keyReleaseEvent(QKeyEvent *e)
Reimplementa: ` QWidget::keyReleaseEvent(QKeyEvent *event)`.
[override virtual protected] void QKeySequenceEdit::timerEvent(QTimerEvent *e)
Reimplementa: ` QObject::timerEvent(QTimerEvent *event)`.
© 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.