QKeySequenceEdit 类
QKeySequenceEdit 小部件允许输入一个 QKeySequence。 更多信息...
| 头文件 | #include <QKeySequenceEdit> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake | QT += widgets |
| 继承 | QWidget |
属性
(自 6.4)clearButtonEnabled : bool(自 6.5)finishingKeyCombinations : QList<QKeyCombination>- keySequence : QKeySequence
(自 6.5)maximumSequenceLength : qsizetype
公共函数
| QKeySequenceEdit(QWidget *parent = nullptr) | |
| QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr) | |
| 虚拟 | ~QKeySequenceEdit() |
| QList<QKeyCombination> | finishingKeyCombinations() const |
| bool | isClearButtonEnabled() const |
| QKeySequence | keySequence() const |
| qsizetype | maximumSequenceLength() const |
| void | setClearButtonEnabled(bool enable) |
| void | setFinishingKeyCombinations(const QList<QKeyCombination> &finishingKeyCombinations) |
公共槽
| void | clear() |
| void | setKeySequence(const QKeySequence &keySequence) |
| void | setMaximumSequenceLength(qsizetype count) |
信号
| void | editingFinished() |
| void | keySequenceChanged(const QKeySequence &keySequence) |
重实现保护函数
| 虚拟 bool | event(QEvent *e) override |
| 虚拟 void | focusOutEvent(QFocusEvent *e) override |
| 虚拟 void | keyPressEvent(QKeyEvent *e) override |
| 虚拟 void | keyReleaseEvent(QKeyEvent *e) override |
| 虚拟 void | timerEvent(QTimerEvent *e) override |
详细描述
此小部件允许用户选择一个QKeySequence，这通常用作快捷键。当小部件获得焦点时开始录制，用户释放最后一个键后一秒结束。
参见QKeySequenceEdit::keySequence。
属性文档
[自 6.4版本起] clearButtonEnabled : bool
该属性表示当键序列编辑不为空时是否显示清除按钮。
如果启用，当键序列编辑包含文本时，小部件将显示尾随的清除按钮；否则，行编辑不会显示清除按钮（默认行为）。
此属性自 Qt 6.4 版本引入。
访问函数
| bool | isClearButtonEnabled() const |
| void | setClearButtonEnabled(bool enable) |
[自 6.5版本起] finishingKeyCombinations : QList<QKeyCombination>
该属性包含完成编辑键序列的组合键列表。
列表中的任何组合都可以完成键序列的编辑。所有其他组合键都可以作为键序列的一部分进行录制。默认情况下，Qt::Key_Tab 和 Qt::Key_Backtab 将完成键序列的录制。
此属性自 Qt 6.5 版本引入。
访问函数
| QList<QKeyCombination> | finishingKeyCombinations() const |
| void | setFinishingKeyCombinations(const QList<QKeyCombination> &finishingKeyCombinations) |
keySequence : QKeySequence
该属性包含当前选择的键序列。
可以通过用户或设置函数更改快捷键。
注意：如果QKeySequence比最大序列长度属性长，则键序列将被截断。
访问函数
| QKeySequence | keySequence() const |
| void | setKeySequence(const QKeySequence &keySequence) |
通知信号
| void | keySequenceChanged(const QKeySequence &keySequence) |
[自 6.5版本起] maximumSequenceLength : qsizetype
该属性包含最大序列长度。
用户可以输入的键序列的最大数量。值需要在1到4之间，默认为4。
此属性自 Qt 6.5 版本引入。
访问函数
| qsizetype | maximumSequenceLength() const |
| void | setMaximumSequenceLength(qsizetype count) |
成员函数文档
[显式] QKeySequenceEdit::QKeySequenceEdit(QWidget *parent = nullptr)
使用给定的父创建一个QKeySequenceEdit小部件。
[显式] QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr)
使用给定的组合键和父创建一个QKeySequenceEdit小部件。
[虚拟 noexcept] QKeySequenceEdit::~QKeySequenceEdit()
销毁QKeySequenceEdit对象。
[槽] void QKeySequenceEdit::clear()
清除当前键序列。
[信号] void QKeySequenceEdit::editingFinished()
当用户完成输入快捷键时，发出此信号。
注意：在释放最后一个键和发出此信号之前，存在一秒钟的延迟。
[覆盖虚保护] bool QKeySequenceEdit::event(QEvent *e)
重新实现：QWidget::event(QEvent *event).
[覆盖虚保护] void QKeySequenceEdit::focusOutEvent(QFocusEvent *e)
重新实现：QWidget::focusOutEvent(QFocusEvent *event).
[覆盖虚保护] void QKeySequenceEdit::keyPressEvent(QKeyEvent *e)
重新实现：QWidget::keyPressEvent(QKeyEvent *event).
[覆盖虚保护] void QKeySequenceEdit::keyReleaseEvent(QKeyEvent *e)
重新实现：QWidget::keyReleaseEvent(QKeyEvent *event).
[覆盖虚保护] void QKeySequenceEdit::timerEvent(QTimerEvent *e)
重新实现：QObject::timerEvent(QTimerEvent *event).
© 2024 The Qt Company Ltd. 本文档中的文档贡献是各自所有者的版权。提供的文档是根据自由软件基金会发布的GNU自由文档许可证版本1.3条款许可的。Qt和相关标志是芬兰的The Qt Company Ltd.以及/或其他国家的商标。所有其他商标归其各自所有者所有。
