QKeySequenceEdit Class
Das Widget „QKeySequenceEdit“ ermöglicht die Eingabe einer „ QKeySequence “. Mehr...
| Überschrift: | #include <QKeySequenceEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt: | QWidget |
Eigenschaften
(since 6.4)clearButtonEnabled : bool(since 6.5)finishingKeyCombinations : QList<QKeyCombination>- keySequence : QKeySequence
(since 6.5)maximumSequenceLength : qsizetype
Öffentliche Funktionen
| 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) |
Öffentliche Slots
| void | clear() |
| void | setKeySequence(const QKeySequence &keySequence) |
| void | setMaximumSequenceLength(qsizetype count) |
Signale
| void | editingFinished() |
| void | keySequenceChanged(const QKeySequence &keySequence) |
Neu implementierte geschützte Funktionen
| 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 |
Detaillierte Beschreibung
Mit diesem Widget kann der Benutzer eine Tastenkombination ( QKeySequence) auswählen, die in der Regel als Tastenkürzel verwendet wird. Die Aufzeichnung beginnt, sobald das Widget den Fokus erhält, und endet eine Sekunde, nachdem der Benutzer die letzte Taste losgelassen hat.
Siehe auch „ QKeySequenceEdit::keySequence “.
Dokumentation der Eigenschaften
[since 6.4] clearButtonEnabled : bool
Diese Eigenschaft legt fest, ob das Eingabefeld für die Tastenkombination eine Schaltfläche „Löschen“ anzeigt, wenn es nicht leer ist.
Wenn diese Eigenschaft aktiviert ist, zeigt das Eingabefeld „Key Sequence Edit“ eine „Löschen“-Schaltfläche am Ende an, sofern es Text enthält; andernfalls wird keine „Löschen“-Schaltfläche angezeigt (Standardeinstellung).
Diese Aufzählung wurde in Qt 6.4 eingeführt.
Zugriffsfunktionen:
| bool | isClearButtonEnabled() const |
| void | setClearButtonEnabled(bool enable) |
[since 6.5] finishingKeyCombinations : QList<QKeyCombination>
Diese Eigenschaft enthält die Liste der Tastenkombinationen, mit denen die Bearbeitung von Tastenfolgen abgeschlossen wird.
Jede Kombination in der Liste beendet die Bearbeitung von Tastenfolgen. Alle anderen Tastenkombinationen können als Teil einer Tastenfolge aufgezeichnet werden. Standardmäßig beenden „ Qt::Key_Tab “ und „ Qt::Key_Backtab “ die Aufzeichnung der Tastenfolge.
Diese Aufzählung wurde in Qt 6.5 eingeführt.
Zugriffsfunktionen:
| QList<QKeyCombination> | finishingKeyCombinations() const |
| void | setFinishingKeyCombinations(const QList<QKeyCombination> &finishingKeyCombinations) |
keySequence : QKeySequence
Diese Eigenschaft enthält die aktuell ausgewählte Tastenkombination.
Die Tastenkombination kann vom Benutzer oder über eine Setter-Funktion geändert werden.
Hinweis: Ist die Eigenschaft „ QKeySequence “ länger als die Eigenschaft „ maximumSequenceLength “, wird die Tastenkombination gekürzt.
Zugriffsfunktionen:
| QKeySequence | keySequence() const |
| void | setKeySequence(const QKeySequence &keySequence) |
Benachrichtigungssignal:
| void | keySequenceChanged(const QKeySequence &keySequence) |
[since 6.5] maximumSequenceLength : qsizetype
Diese Eigenschaft gibt die maximale Sequenzlänge an.
Die maximale Anzahl von Tastenfolgen, die ein Benutzer eingeben kann. Der Wert muss zwischen 1 und 4 liegen, wobei 4 der Standardwert ist.
Diese Enumeration wurde in Qt 6.5 eingeführt.
Zugriffsfunktionen:
| qsizetype | maximumSequenceLength() const |
| void | setMaximumSequenceLength(qsizetype count) |
Dokumentation zu den Member-Funktionen
[explicit] QKeySequenceEdit::QKeySequenceEdit(QWidget *parent = nullptr)
Erstellt ein QKeySequenceEdit-Widget mit dem angegebenen „ parent “.
[explicit] QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr)
Erstellt ein `QKeySequenceEdit`-Widget mit den angegebenen Werten für ` keySequence ` und ` parent`.
[virtual noexcept] QKeySequenceEdit::~QKeySequenceEdit()
Löscht das Objekt „ QKeySequenceEdit “.
[slot] void QKeySequenceEdit::clear()
Löscht die aktuelle Tastenfolge.
[signal] void QKeySequenceEdit::editingFinished()
Dieses Signal wird ausgegeben, wenn der Benutzer die Eingabe des Tastenkürzels beendet hat.
Hinweis: Zwischen dem Loslassen der letzten Taste und der Ausgabe dieses Signalsliegt eine Verzögerung von einer Sekunde.
[override virtual protected] bool QKeySequenceEdit::event(QEvent *e)
Umsetzt: QWidget::event(QEvent *event).
[override virtual protected] void QKeySequenceEdit::focusOutEvent(QFocusEvent *e)
Implementiert: ` QWidget::focusOutEvent(QFocusEvent *event)`.
[override virtual protected] void QKeySequenceEdit::keyPressEvent(QKeyEvent *e)
Implementiert: ` QWidget::keyPressEvent(QKeyEvent *event)`.
[override virtual protected] void QKeySequenceEdit::keyReleaseEvent(QKeyEvent *e)
Implementiert: ` QWidget::keyReleaseEvent(QKeyEvent *event)`.
[override virtual protected] void QKeySequenceEdit::timerEvent(QTimerEvent *e)
Implementiert: ` 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.
