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事件。根据事件的多义性，如果按键操作发生在快捷键的context 内，该快捷键将调用member 函数；否则将调用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)

这是一个 QShortcut 便捷构造函数，它将快捷方式的activated() 信号连接到functor ，并将activatedAmbiguously() 信号连接到functorAmbiguous 。

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)

这是一个 QShortcut 便捷构造函数，它将快捷方式的 `activated()` 信号连接到 `functor `，并将 `activatedAmbiguously()` 信号连接到 `functorAmbiguous`。

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)

这是一个 QShortcut 便捷构造函数，它将快捷方式的 `activated()` 信号连接到 `functor `，并将 `activatedAmbiguously()` 信号连接到 `functorAmbiguous`。

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)

这是一个 QShortcut 便捷构造函数，它将快捷方式的 `activated()` 信号连接到 `functor `，并将 `activatedAmbiguously()` 信号连接到 `functorAmbiguous`。

functor 可以是context1 对象的某个成员函数的指针。functorAmbiguous 可以是context2 对象的某个成员函数的指针。

如果context1 对象被销毁，则不会调用functor 。如果context2 对象被销毁，则不会调用functorAmbiguous 。

[virtual noexcept] QShortcut::~QShortcut()

删除该快捷方式。

[signal] void QShortcut::activated()

当用户输入快捷键的键序列时，会发出此信号。

另请参阅 activatedAmbiguously()。

[signal] void QShortcut::activatedAmbiguously()

当在键盘上输入一组键序列时，只要该键序列与多个快捷键的开头匹配，就称其为“模棱两可”。

当快捷键的按键序列输入完成时，如果该按键序列仍然存在歧义（即它是另一个或多个快捷键的开头），则会发出 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 。

当小部件应用程序处于“这是什么？”模式时，如果用户输入快捷键序列key()，将显示该文本。

若要在菜单项上设置“这是什么？”帮助（无论该菜单项是否带有快捷键），请在该菜单项的操作上设置帮助。

默认情况下，帮助文本为空字符串。

在未使用小部件的应用程序中，此函数无效。

另请参阅 whatsThis()、QWhatsThis::inWhatsThisMode() 和QAction::setWhatsThis()。

QString QShortcut::whatsThis() const

返回快捷方式的“这是什么？”帮助文本。

另请参阅 setWhatsThis()。