QKeySequenceEdit Class
Le widget QKeySequenceEdit permet de saisir une séquence de touches ( QKeySequence). En savoir plus...
| En-tête : | #include <QKeySequenceEdit> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QWidget |
Propriétés
(since 6.4)clearButtonEnabled : bool(since 6.5)finishingKeyCombinations : QList<QKeyCombination>- keySequence : QKeySequence
(since 6.5)maximumSequenceLength : qsizetype
Fonctions publiques
| 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) |
Emplacements publics
| void | clear() |
| void | setKeySequence(const QKeySequence &keySequence) |
| void | setMaximumSequenceLength(qsizetype count) |
Signaux
| void | editingFinished() |
| void | keySequenceChanged(const QKeySequence &keySequence) |
Fonctions protégées réimplémentées
| 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 |
Description détaillée
Ce widget permet à l'utilisateur de choisir un enregistrement de frappe ( QKeySequence), généralement utilisé comme raccourci. L' est lancé lorsque le widget reçoit le focus et se termine une seconde après que l'utilisateur a relâché la dernière touche.
Voir aussi QKeySequenceEdit::keySequence.
Documentation des propriétés
[since 6.4] clearButtonEnabled : bool
Cette propriété détermine si la zone d'édition de séquence de touches affiche un bouton « Effacer » lorsqu'elle n'est pas vide.
Si cette propriété est activée, la zone de saisie de séquence de touches affiche un bouton « Effacer » à la fin lorsqu'elle contient du texte ; dans le cas contraire, la zone de saisie n'affiche pas de bouton « Effacer » (valeur par défaut).
Cette énumération a été introduite dans Qt 6.4.
Fonctions d'accès :
| bool | isClearButtonEnabled() const |
| void | setClearButtonEnabled(bool enable) |
[since 6.5] finishingKeyCombinations : QList<QKeyCombination>
Cette propriété contient la liste des combinaisons de touches permettant de terminer la modification des séquences de touches.
Toute combinaison figurant dans cette liste mettra fin à l’édition d’une séquence de touches. Toutes les autres combinaisons de touches peuvent être enregistrées dans le cadre d’une séquence de touches. Par défaut, les combinaisons « Qt::Key_Tab » et « Qt::Key_Backtab » mettent fin à l’enregistrement de la séquence de touches.
Cette énumération a été introduite dans Qt 6.5.
Fonctions d’accès :
| QList<QKeyCombination> | finishingKeyCombinations() const |
| void | setFinishingKeyCombinations(const QList<QKeyCombination> &finishingKeyCombinations) |
keySequence : QKeySequence
Cette propriété contient la séquence de touches actuellement sélectionnée.
Le raccourci peut être modifié par l'utilisateur ou via une fonction de mise en valeur.
Remarque : si l'QKeySequence e est plus long que la propriété « maximumSequenceLength », la séquence de touches est tronquée.
Fonctions d'accès :
| QKeySequence | keySequence() const |
| void | setKeySequence(const QKeySequence &keySequence) |
Signal de notification :
| void | keySequenceChanged(const QKeySequence &keySequence) |
[since 6.5] maximumSequenceLength : qsizetype
Cette propriété définit la longueur maximale d'une séquence.
Nombre maximal de séquences de touches qu'un utilisateur peut saisir. La valeur doit être comprise entre 1 et 4, la valeur par défaut étant 4.
Cette énumération a été introduite dans Qt 6.5.
Fonctions d'accès :
| qsizetype | maximumSequenceLength() const |
| void | setMaximumSequenceLength(qsizetype count) |
Documentation des fonctions membres
[explicit] QKeySequenceEdit::QKeySequenceEdit(QWidget *parent = nullptr)
Crée un widget QKeySequenceEdit avec l'parent on fournie.
[explicit] QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr)
Crée un widget `QKeySequenceEdit` avec les paramètres ` keySequence ` et ` parent` fournis.
[virtual noexcept] QKeySequenceEdit::~QKeySequenceEdit()
Supprime l'objet « QKeySequenceEdit ».
[slot] void QKeySequenceEdit::clear()
Efface la séquence de touches actuelle.
[signal] void QKeySequenceEdit::editingFinished()
Ce signal est émis lorsque l'utilisateur a fini de saisir le raccourci.
Remarque : il y a un délai d'une seconde entre le moment où la dernière touche est relâchée et celui où ce signal est émis.
[override virtual protected] bool QKeySequenceEdit::event(QEvent *e)
Réimplémente : QWidget::event(QEvent *event).
[override virtual protected] void QKeySequenceEdit::focusOutEvent(QFocusEvent *e)
Réimplémente : QWidget::focusOutEvent(QFocusEvent *event).
[override virtual protected] void QKeySequenceEdit::keyPressEvent(QKeyEvent *e)
Réimplémente : QWidget::keyPressEvent(QKeyEvent *event).
[override virtual protected] void QKeySequenceEdit::keyReleaseEvent(QKeyEvent *e)
Réimplémente : QWidget::keyReleaseEvent(QKeyEvent *event).
[override virtual protected] void QKeySequenceEdit::timerEvent(QTimerEvent *e)
Réimplémente : 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.
