QKeySequenceEdit Class
QKeySequenceEdit 위젯을 사용하면 키 시퀀스( QKeySequence)를 입력할 수 있습니다. 더 보기...
| 헤더: | #include <QKeySequenceEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QWidget |
속성
(since 6.4)clearButtonEnabled : bool(since 6.5)finishingKeyCombinations : QList<QKeyCombination>- keySequence : QKeySequence
(since 6.5)maximumSequenceLength : qsizetype
공개 함수
| 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) |
공개 슬롯
| void | clear() |
| void | setKeySequence(const QKeySequence &keySequence) |
| void | setMaximumSequenceLength(qsizetype count) |
신호
| void | editingFinished() |
| void | keySequenceChanged(const QKeySequence &keySequence) |
재구현된 보호 함수
| 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 |
상세 설명
이 위젯을 통해 사용자는 일반적으로 단축키로 사용되는 키 조합( QKeySequence)을 선택할 수 있습니다. 녹화는 위젯이 포커스를 받을 때 시작되며, 사용자가 마지막 키를 놓은 지 1초 후에 종료됩니다.
QKeySequenceEdit::keySequence도 참조하십시오 .
속성 설명
[since 6.4] clearButtonEnabled : bool
이 속성은 키 시퀀스 편집창의 내용이 비어 있지 않을 때 지우기 버튼이 표시되는지 여부를 결정합니다.
이 옵션이 활성화되면, 키 시퀀스 편집 상자에 텍스트가 포함된 경우 끝에 '지우기' 버튼이 표시되며, 그렇지 않은 경우 라인 편집 상자에는 '지우기' 버튼이 표시되지 않습니다(기본값).
이 열거형은 Qt 6.4에서 도입되었습니다.
액세스 함수:
| bool | isClearButtonEnabled() const |
| void | setClearButtonEnabled(bool enable) |
[since 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 `가 ` maximumSequenceLength ` 속성보다 길경우 , 키 시퀀스가 잘립니다.
액세스 함수:
| QKeySequence | keySequence() const |
| void | setKeySequence(const QKeySequence &keySequence) |
알림 신호:
| void | keySequenceChanged(const QKeySequence &keySequence) |
[since 6.5] maximumSequenceLength : qsizetype
이 속성은 최대 시퀀스 길이를 저장합니다.
사용자가 입력할 수 있는 키 시퀀스의 최대 개수입니다. 값은 1에서 4 사이여야 하며, 기본값은 4입니다.
이 열거형은 Qt 6.5에서 도입되었습니다.
액세스 함수:
| qsizetype | maximumSequenceLength() const |
| void | setMaximumSequenceLength(qsizetype count) |
멤버 함수 문서
[explicit] QKeySequenceEdit::QKeySequenceEdit(QWidget *parent = nullptr)
지정된 ` parent`을 사용하여 `QKeySequenceEdit` 위젯을 생성합니다.
[explicit] QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent = nullptr)
지정된 ` keySequence ` 및 ` parent`을 사용하여 `QKeySequenceEdit` 위젯을 생성합니다.
[virtual noexcept] QKeySequenceEdit::~QKeySequenceEdit()
QKeySequenceEdit 객체를 삭제합니다.
[slot] void QKeySequenceEdit::clear()
현재 키 입력 시퀀스를 지웁니다.
[signal] void QKeySequenceEdit::editingFinished()
사용자가 단축키 입력을 완료하면 이 신호가 전송됩니다.
참고: 마지막 키를 놓은 후 이 신호가 발생하기까지 1초의 지연 시간이있습니다 .
[override virtual protected] bool QKeySequenceEdit::event(QEvent *e)
QWidget::event(QEvent *event)를 재구현합니다.
[override virtual protected] void QKeySequenceEdit::focusOutEvent(QFocusEvent *e)
QWidget::focusOutEvent(QFocusEvent *event)를 재구현합니다.
[override virtual protected] void QKeySequenceEdit::keyPressEvent(QKeyEvent *e)
QWidget::keyPressEvent(QKeyEvent *event)를 재구현합니다.
[override virtual protected] void QKeySequenceEdit::keyReleaseEvent(QKeyEvent *e)
QWidget::keyReleaseEvent(QKeyEvent *event)를 재구현합니다.
[override virtual protected] void QKeySequenceEdit::timerEvent(QTimerEvent *e)
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.
