QKeySequenceEdit Class
Le widget QKeySequenceEdit permet de saisir une QKeySequence. Plus....
| En-tête : | #include <QKeySequenceEdit> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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 QKeySequence, qui est généralement utilisé comme raccourci. L'enregistrement 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 également QKeySequenceEdit::keySequence.
Documentation sur les propriétés
[since 6.4] clearButtonEnabled : bool
Cette propriété indique si l'édition de la séquence de touches affiche un bouton d'effacement lorsqu'elle n'est pas vide.
Si cette propriété est activée, l'édition de la séquence de touches affiche un bouton d'effacement en fin de ligne lorsqu'elle contient du texte, sinon l'édition de la ligne n'affiche pas de bouton d'effacement (par défaut).
Cette propriété 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 qui terminent l'édition des séquences de touches.
Toute combinaison figurant dans la liste termine l'édition des séquences de touches. Toutes les autres combinaisons de touches peuvent être enregistrées en tant que partie d'une séquence de touches. Par défaut, Qt::Key_Tab et Qt::Key_Backtab terminent l'enregistrement de la séquence de touches.
Cette propriété 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 par une fonction setter.
Remarque : si la propriété QKeySequence est plus longue 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é indique la longueur maximale de la séquence.
Il s'agit du nombre maximal de séquences de touches qu'un utilisateur peut saisir. La valeur doit être comprise entre 1 et 4, 4 étant la valeur par défaut.
Cette propriété 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)
Construit un widget QKeySequenceEdit avec l'adresse parent.
[explicit] QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr)
Construit un widget QKeySequenceEdit avec les données keySequence et parent.
[virtual noexcept] QKeySequenceEdit::~QKeySequenceEdit()
Détruit 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.
Note : il y a un délai d'une seconde avant de relâcher la dernière touche et d'émettre ce signal.
[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.
