QShortcut Class

shortcut = new QShortcut(QKeySequence(tr("Ctrl+O", "File|Open")),
                        parent);

setKey(0);                  // no signal emitted
setKey(QKeySequence());     // no signal emitted
setKey(0x3b1);              // Greek letter alpha
setKey(Qt::Key_D);              // 'd', e.g. to delete
setKey('q');                // 'q', e.g. to quit
setKey(Qt::CTRL | Qt::Key_P);       // Ctrl+P, e.g. to print document
setKey(tr("Ctrl+P"));           // Ctrl+P, e.g. to print document

メンバー関数のドキュメント

[explicit] QShortcut::QShortcut(QObject *parent)

parent 用のQShortcutオブジェクトを生成します。 は、QWindow またはQWidget である必要があります。

ショートカットキーのシーケンスが指定されていないため、このショートカットはシグナルを発信しません。

setKey()も参照してください 。

[explicit, since 6.0] QShortcut::QShortcut(QKeySequence::StandardKey standardKey, QObject *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)

parent 用の QShortcut オブジェクトを構築します。 は、QWindow またはQWidget である必要があります。

このショートカットは親オブジェクトに対して動作し、standardKey に一致するQShortcutEventを監視します。イベントの曖昧性に応じて、ショートカットは、キー押下がショートカットのcontext 内で行われた場合、member 関数またはambiguousMember 関数を呼び出します。

この関数は Qt 6.0 で導入されました。

[explicit] QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)

parent に対する QShortcut オブジェクトを構築します。 は、QWindow またはQWidget である必要があります。

このショートカットは親オブジェクトに対して動作し、key シーケンスに一致するQShortcutEventをリッスンします。イベントの曖昧度に応じて、ショートカットはmember 関数を呼び出すか、キー押下がショートカットのcontext 内で行われた場合はambiguousMember 関数を呼び出します。

[since 6.0] template <typename Functor> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

これは、ショートカットのactivated()シグナルをfunctor に接続する、QShortcutの利便性向上のためのコンストラクタです。

この関数は Qt 6.0 で導入されました。

template <typename Functor> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

これは、ショートカットのactivated()シグナルをfunctor に接続する、QShortcutの便利コンストラクタです。

[since 6.0] template <typename Functor> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

これは、ショートカットのactivated()シグナルをfunctor に接続する、QShortcutの便利コンストラクタです。

functor は、context オブジェクトのメンバ関数へのポインタにすることができます。

context オブジェクトが破棄された場合、functor は呼び出されません。

この関数は Qt 6.0 で導入されました。

template <typename Functor> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

これは、ショートカットのactivated()シグナルをfunctor に接続する、QShortcutの便利コンストラクタです。

functor は、context オブジェクトのメンバ関数へのポインタでも構いません。

context オブジェクトが破棄された場合、functor は呼び出されません。

[since 6.0] template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context, Functor functor, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

これは、ショートカットのactivated()シグナルをfunctor に、activatedAmbiguously()シグナルをfunctorAmbiguous に接続する、QShortcutの便利コンストラクタです。

functor およびfunctorAmbiguous には、context オブジェクトのメンバ関数へのポインタを指定できます。

context オブジェクトが破棄された場合、functor およびfunctorAmbiguous は呼び出されません。

この関数は Qt 6.0 で導入されました。

template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context, Functor functor, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

これは、ショートカットのactivated()シグナルをfunctor に、activatedAmbiguously()シグナルをfunctorAmbiguous に接続する、QShortcutの利便性向上のためのコンストラクタです。

functor およびfunctorAmbiguous は、context オブジェクトのメンバ関数へのポインタにすることができます。

context オブジェクトが破棄された場合、functor およびfunctorAmbiguous は呼び出されません。

[since 6.0] template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context1, Functor functor, const QObject *context2, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

これは、ショートカットのactivated()シグナルをfunctor に接続し、activatedAmbiguously()シグナルをfunctorAmbiguous に接続する、QShortcutの利便性向上のためのコンストラクタです。

functor には、context1 オブジェクトのメンバ関数へのポインタを指定できます。functorAmbiguous には、context2 オブジェクトのメンバ関数へのポインタを指定できます。

context1 オブジェクトが破棄された場合、functor は呼び出されません。context2 オブジェクトが破棄された場合、functorAmbiguous は呼び出されません。

この関数は Qt 6.0 で導入されました。

template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context1, Functor functor, const QObject *context2, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

これは、ショートカットのactivated()シグナルをfunctor に接続し、activatedAmbiguously()シグナルをfunctorAmbiguous に接続する、QShortcutの利便性向上のためのコンストラクタです。

functor には、context1 オブジェクトのメンバ関数へのポインタを指定できます。functorAmbiguous には、context2 オブジェクトのメンバ関数へのポインタを指定できます。

context1 オブジェクトが破棄された場合、functor は呼び出されません。context2 オブジェクトが破棄された場合、functorAmbiguous は呼び出されません。

[virtual noexcept] QShortcut::~QShortcut()

ショートカットを削除します。

[signal] void QShortcut::activated()

このシグナルは、ユーザーがショートカットのキーシーケンスを入力したときに発生します。

activatedAmbiguously()も参照してください 。

[signal] void QShortcut::activatedAmbiguously()

キーボードでキーシーケンスが入力されている際、そのキーシーケンスが複数のショートカットの開始部分と一致している限り、そのキーシーケンスは「曖昧」であるとみなされます。

ショートカットのキーシーケンスが入力完了した時点で、そのキーシーケンスが依然として曖昧である場合（つまり、他の1つ以上のショートカットの開始部分である場合）、activatedAmbiguously() が発火します。この場合、activated() シグナルは発火しません。

activated()も参照してください 。

[since 6.0] QList<QKeySequence> QShortcut::keys() const

このショートカットを起動するキーシーケンスのリストを返します。

この関数は Qt 6.0 で導入されました。

key およびsetKeys()も参照してください 。

QWidget *QShortcut::parentWidget() const

ショートカットの親ウィジェットを返します。

[since 6.0] void QShortcut::setKeys(QKeySequence::StandardKey key)

トリガーを、標準キーkey に一致するものに設定します。

この関数は Qt 6.0 で導入されました。

key およびkeys()も参照してください 。

[since 6.0] void QShortcut::setKeys(const QList<QKeySequence> &keys)

keys を、ショートカットを起動するキーシーケンスのリストとして設定します。

この関数は Qt 6.0 で導入されました。

key およびkeys()も参照してください 。

void QShortcut::setWhatsThis(const QString &text)

ショートカットの「これは何？」ヘルプtext を設定します。

このテキストは、ウィジェットアプリケーションが「What's This?」モードになっているときに、ユーザーがショートカットのkey()のキーシーケンスを入力すると表示されます。

メニュー項目（ショートカットキーの有無にかかわらず）に「What's This?」ヘルプを設定するには、その項目のアクションにヘルプを設定します。

デフォルトでは、ヘルプテキストは空の文字列です。

この関数は、ウィジェットを使用しないアプリケーションでは効果はありません。

whatsThis()、QWhatsThis::inWhatsThisMode()、およびQAction::setWhatsThis()も参照してください 。

QString QShortcut::whatsThis() const

ショートカットの「これは何？」ヘルプテキストを返します。

setWhatsThis()も参照してください 。