QKeySequenceEdit Class
El widget QKeySequenceEdit permite introducir una QKeySequence. Más...
| Cabecera: | #include <QKeySequenceEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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 elegir un QKeySequence, que normalmente se utiliza 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 la secuencia de teclas muestra un botón de borrado cuando no está vacía.
Si está habilitada, la secuencia de teclas muestra un botón de borrado cuando contiene algún texto, de lo contrario la línea de edición no muestra un botón de borrado (por defecto).
Esta propiedad 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 secuencias de teclas. Todas las demás combinaciones de teclas pueden grabarse 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 propiedad 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 elegida actualmente.
El acceso directo puede ser cambiado por el usuario o mediante la función setter.
Nota: Si 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 del notificador:
| void | keySequenceChanged(const QKeySequence &keySequence) |
[since 6.5] maximumSequenceLength : qsizetype
Esta propiedad contiene la longitud máxima de la secuencia.
Es el número máximo de secuencias de teclas que un usuario puede introducir. El valor debe estar entre 1 y 4, siendo 4 el valor por defecto.
Esta propiedad se introdujo en Qt 6.5.
Funciones de acceso:
| qsizetype | maximumSequenceLength() const |
| void | setMaximumSequenceLength(qsizetype count) |
Documentación de funciones miembro
[explicit] QKeySequenceEdit::QKeySequenceEdit(QWidget *parent = nullptr)
Construye un widget QKeySequenceEdit con la dirección parent.
[explicit] QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr)
Construye un widget QKeySequenceEdit con los datos keySequence y parent.
[virtual noexcept] QKeySequenceEdit::~QKeySequenceEdit()
Destruye 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 acceso directo.
Nota: hay un retardo de un segundo antes de soltar la última tecla y emitir 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.
