En esta página

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

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.