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("Ctrl+P");           // Ctrl+P, e.g. to print document

メンバ関数ドキュメント

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

QWindow またはQWidget であるべきparent の QShortcut オブジェクトを構築します。

ショートカットのキー配列が指定されていないので、ショートカットはシグナルを発しません。

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)

QWindow またはQWidget であるべきparent の QShortcut オブジェクトを構築する。

ショートカットはその親を操作し、standardKey にマッチするQShortcutEventをリッスンします。イベントの曖昧さに応じて、ショートカットはmember 関数を呼び出します。また、キーがショートカットのcontext にあった場合は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)

QWindow またはQWidget であるべきparent の QShortcut オブジェクトを構築します。

ショートカットはその親を操作し、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)

これはオーバーロードされた関数です。

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

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

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

これはオーバーロードされた関数です。

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

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

これはオーバーロードされた関数です。

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

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)

これはオーバーロードされた関数です。

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

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)

ショートカットの "What's This? "ヘルプtext を設定する。

このテキストは、ウィジェット・アプリケーションが "What's This? "モードで、ユーザがショートカットkey() シーケンスをタイプしたときに表示されます。

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

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

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

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

QString QShortcut::whatsThis() const

ショートカットの "What's This?" ヘルプテキストを返します。

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