Qt QShortcut快捷键类详解

1.简介

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

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

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

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

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

cpp 复制代码
  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

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

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

2.常用方法

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

cpp 复制代码
QShortcut(const QKeySequence &key, QObject *parent):

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

cpp 复制代码
 setKey(const QKeySequence &key)

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

cpp 复制代码
setWhatsThis(const QString &text):

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

cpp 复制代码
setEnabled(bool enabled)

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

cpp 复制代码
setContext(Qt::ShortcutContext context)

信号:

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

cpp 复制代码
activatedAmbiguously()

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

cpp 复制代码
activated():

3.示例

cpp 复制代码
#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();
}

4.避免快捷键冲突

可能会出现快捷键冲突的情况,即两个或多个快捷键具有相同的键组合,或者在特定的上下文中,一个快捷键被另一个窗口或应用程序占用。这可能导致快捷键无法按预期工作,或者触发错误的动作。

检查可用性:在注册快捷键之前,可以检查该快捷键是否已经被其他 QShortcut 实例使用,或者是否与操作系统的快捷键冲突。QShortcut 提供了一个 setContext 方法,可以用来限制快捷键的触发上下文(例如,只在应用程序有焦点时触发)。

使用独一无二的组合:尽量使用不常见的键组合作为快捷键,比如使用功能键(F1-F12)或者组合键(Ctrl+Alt+Shift+Key)。

使用 activatedAmbiguously 信号:当快捷键可能不明确时,QShortcut 会发出 activatedAmbiguously 信号。你可以连接这个信号来处理潜在的冲突,例如,显示一个警告对话框或者忽略该快捷键的触发。

5.更多参考

libVLC 专栏介绍-CSDN博客

Qt+FFmpeg+opengl从零制作视频播放器-1.项目介绍_qt opengl视频播放器-CSDN博客

QCharts -1.概述-CSDN博客

相关推荐
lsx2024064 分钟前
SQL SELECT 语句:基础与进阶应用
开发语言
开心工作室_kaic29 分钟前
ssm161基于web的资源共享平台的共享与开发+jsp(论文+源码)_kaic
java·开发语言·前端
向宇it30 分钟前
【unity小技巧】unity 什么是反射?反射的作用?反射的使用场景?反射的缺点?常用的反射操作?反射常见示例
开发语言·游戏·unity·c#·游戏引擎
武子康35 分钟前
Java-06 深入浅出 MyBatis - 一对一模型 SqlMapConfig 与 Mapper 详细讲解测试
java·开发语言·数据仓库·sql·mybatis·springboot·springcloud
转世成为计算机大神1 小时前
易考八股文之Java中的设计模式?
java·开发语言·设计模式
机器视觉知识推荐、就业指导1 小时前
C++设计模式:建造者模式(Builder) 房屋建造案例
c++
宅小海1 小时前
scala String
大数据·开发语言·scala
qq_327342731 小时前
Java实现离线身份证号码OCR识别
java·开发语言
锅包肉的九珍1 小时前
Scala的Array数组
开发语言·后端·scala
心仪悦悦2 小时前
Scala的Array(2)
开发语言·后端·scala