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.
