当前位置：首页 > news >正文

Qt QShortcut快捷键类详解

news 2025/8/26 3:38:20

1.简介

QShortcut是一个方便的工具类，用于在应用程序中创建快捷键。通过设置快捷键和关联的处理函数，可以实现快速执行某个操作的功能。

// 创建一个快捷键，关联到MyWidget类的keyPressEvent()函数
QShortcut *shortcut = new QShortcut(QKeySequence("Ctrl+K"), this);
connect(shortcut, &QShortcut::activated, this, &MyWidget::keyPressEvent)

QKeySequence是一个字符串序列，用于表示一系列的键盘按键。通过使用QKeySequence，可以方便地生成快捷键，并将其与特定的处理函数关联起来。

QKeySequence sequence("Ctrl+K"); // 创建一个表示"Ctrl+K"的键盘序列
QShortcut *shortcut = new QShortcut(sequence, this);
connect(shortcut, &QShortcut::activated, this, &MyWidget::keyPressEvent);

QKeySequence是一个可选组合了Shift、Ctrl和Alt的键序列。可以通过多种方式提供该键序列：

  setKey(0);                  // no signal emittedsetKey(QKeySequence());     // no signal emittedsetKey(0x3b1);              // Greek letter alphasetKey(Qt::Key_D);              // 'd', e.g. to deletesetKey('q');                // 'q', e.g. to quitsetKey(Qt::CTRL + Qt::Key_P);       // Ctrl+P, e.g. to print documentsetKey("Ctrl+P");           // Ctrl+P, e.g. to print document

QShortcut的工作原理主要基于Qt的事件处理机制，当用户按下键盘上的键时，Qt 会生成一个键盘事件（QKeyEvent），QShortcut监听这些事件，并在检测到与已注册的快捷键匹配的键组合时触发相应的动作。

需要注意的是，QShortcut只对键盘事件有效。如果你需要监听鼠标事件或其他类型的事件，你需要使用其他机制，比如QAction或自定义的事件过滤器。

2.常用方法

构造函数：创建一个 QShortcut 实例，key 是快捷键组合，parent 是父对象。

QShortcut(const QKeySequence &key, QObject *parent)：

设置快捷键：设置快捷键组合。

 setKey(const QKeySequence &key)

设置快捷键的描述，这可以在帮助系统中显示。

setWhatsThis(const QString &text)：

激活快捷键：启用或禁用快捷键。

setEnabled(bool enabled)

设置快捷方式有效的上下文。

setContext(Qt::ShortcutContext context)

信号：
当快捷键可能不明确（即有多个快捷键具有相同的键组合）时发出这个信号。

activatedAmbiguously()

当快捷键被激活时发出这个信号。

activated()：

3.示例

#include "widget.h"
#include <QApplication>
#include <QShortcut>int main(int argc, char *argv[])
{QApplication a(argc, argv);Widget w;w.show();//创建一个快捷键，当用户按下 Ctrl+P 时退出程序QShortcut *shortcut = new QShortcut(QKeySequence(Qt::CTRL | Qt::Key_P), &w);QObject::connect(shortcut, &QShortcut::activated, [&]() {qApp->exit();});return a.exec();
}