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).
© 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.
