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)

为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。根据事件的模糊性，快捷方式将调用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)

为parent 构建一个 QShortcut 对象，它应该是QWindow 或QWidget 。

快捷方式对其父对象进行操作，监听与key 序列相匹配的QShortcutEvents。根据事件的模糊性，快捷方式将调用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)

这是一个重载函数。

这是一个 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

返回快捷方式的父 widget。

[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 。

当 Widget 应用程序处于 "这是什么？"模式，且用户键入快捷键key() 序列时，将显示该文本。

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

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

在不使用部件的应用程序中，该函数不起作用。

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

QString QShortcut::whatsThis() const

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

另请参阅 setWhatsThis()。