QKeySequenceEdit Class
Das QKeySequenceEdit-Widget erlaubt die Eingabe einer QKeySequence. Mehr....
| Kopfzeile: | #include <QKeySequenceEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbungen: | 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) |
Reimplementierte 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 |
Ausführliche Beschreibung
Mit diesem Widget kann der Benutzer eine QKeySequence auswählen, die in der Regel als Tastenkürzel verwendet wird. Die Aufzeichnung wird gestartet, wenn das Widget den Fokus erhält, und endet eine Sekunde, nachdem der Benutzer die letzte Taste losgelassen hat.
Siehe auch QKeySequenceEdit::keySequence.
Eigenschaft Dokumentation
[since 6.4] clearButtonEnabled : bool
Diese Eigenschaft legt fest, ob bei der Bearbeitung einer Tastenfolge eine Schaltfläche zum Löschen angezeigt wird, wenn sie nicht leer ist.
Wenn sie aktiviert ist, zeigt die Tastensequenz-Editierung einen hinteren Löschknopf an, wenn sie Text enthält, andernfalls zeigt die Zeilen-Editierung keinen Löschknopf an (die Voreinstellung).
Diese Eigenschaft 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, die die Bearbeitung der Tastenfolgen beenden.
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 Tastensequenz.
Diese Eigenschaft 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 gewählte Tastenfolge.
Die Tastenkombination kann vom Benutzer oder über eine Setter-Funktion geändert werden.
Hinweis: Wenn QKeySequence länger ist als die Eigenschaft maximumSequenceLength, wird die Tastenfolge abgeschnitten.
Zugriffsfunktionen:
| QKeySequence | keySequence() const |
| void | setKeySequence(const QKeySequence &keySequence) |
Notifier-Signal:
| void | keySequenceChanged(const QKeySequence &keySequence) |
[since 6.5] maximumSequenceLength : qsizetype
Diese Eigenschaft enthält die maximale Sequenzlänge.
Die maximale Anzahl von Tastenfolgen, die ein Benutzer eingeben kann. Der Wert muss zwischen 1 und 4 liegen, wobei 4 der Standardwert ist.
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
Zugriffsfunktionen:
| qsizetype | maximumSequenceLength() const |
| void | setMaximumSequenceLength(qsizetype count) |
Dokumentation der Mitgliedsfunktionen
[explicit] QKeySequenceEdit::QKeySequenceEdit(QWidget *parent = nullptr)
Konstruiert ein QKeySequenceEdit-Widget mit dem angegebenen parent.
[explicit] QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr)
Konstruiert ein QKeySequenceEdit-Widget mit den angegebenen keySequence und parent.
[virtual noexcept] QKeySequenceEdit::~QKeySequenceEdit()
Zerstört 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 Tastaturkürzels beendet.
Hinweis: Es gibt eine Verzögerung von einer Sekunde, bevor die letzte Taste losgelassen und dieses Signal ausgegeben wird.
[override virtual protected] bool QKeySequenceEdit::event(QEvent *e)
Reimplements: QWidget::event(QEvent *Event).
[override virtual protected] void QKeySequenceEdit::focusOutEvent(QFocusEvent *e)
Reimplements: QWidget::focusOutEvent(QFocusEvent *event).
[override virtual protected] void QKeySequenceEdit::keyPressEvent(QKeyEvent *e)
Reimplements: QWidget::keyPressEvent(QKeyEvent *event).
[override virtual protected] void QKeySequenceEdit::keyReleaseEvent(QKeyEvent *e)
Reimplements: QWidget::keyReleaseEvent(QKeyEvent *event).
[override virtual protected] void QKeySequenceEdit::timerEvent(QTimerEvent *e)
Reimplements: QObject::timerEvent(QTimerEvent *event).
© 2025 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.
