Qt 全局热键之使用QxtGlobalShortcut实现

发布时间 2023-03-23 20:50:01作者: 一杯清酒邀明月

全局热键,我们普遍关心的三个问题

  1. 检测快捷键是否被占用
  2. 注册(反注册)快捷键
  3. 快捷键被触发

本文就介绍QxtGlobalShortcut在Qt5中的应用,看看最简单使用步骤和例子:

  1. 把qxtglobalshortcut5文件放在项目目录下,在项目.pro加入一句,include(qxtglobalshortcut5-master/qxt.pri)(这个具体的目录名称,自己可以修改)
  2. 使用,包含头文件#include “qxtglobalshortcut.h”

 

 1 #include "mainwindow.h"
 2 #include "ui_mainwindow.h"
 3 #include <QDebug>
 4 #include "qxtglobalshortcut.h"
 5 MainWindow::MainWindow(QWidget *parent) :
 6     QMainWindow(parent),
 7     ui(new Ui::MainWindow)
 8 {
 9     ui->setupUi(this);
10     QxtGlobalShortcut *shortcut = new QxtGlobalShortcut(this);
11     if(shortcut->setShortcut(QKeySequence("Shift+1")))
12     {
13         connect(shortcut, &QxtGlobalShortcut::activated,
14             [=]() {qDebug() << "shortcut activated";});
15     }
16     else
17     {
18         qDebug()<<"快捷键已占用";
19     }
20 }

 

说明:shortcut->setShortcut(QKeySequence(“Shift+1”));
如果你输入的是QString("")这样不存在的快捷键,返回值也是false,和快捷键被占用返回的false值一样。
但是这样已经够我们使用了,只有你在这里的参数放入的是一个合法的快捷键或者快捷键组合的字符串(而非空字符串),那么就能检测出该快捷键是否被占用。

现在做一个在项目中可能会用到的例子:
先看运行结果:

我们可以捕获键盘输入的快捷键,然后按设置的快捷键就会触发,触发的次数会在label中显示出来。
第一步下载:https://github.com/ddqd/qxtglobalshortcut5
下载后解压出来放到我们新建的工程目录中,我们的qt工程是基于QWidget的,这里选择是这个(你可以选择其他的)

 将下载后的解压出来,命名为qxtglobalshortcut5,进入这文件夹可以看到

 第二步,将这个qxt.pri添加到我们的工厂pro文件中
在pro文件中添加

include(./qxtglobalshortcut5/qxt.pri)

第三步,开始使用。
QKeySequenceEdit一次可以输入4组快捷键,中间用,分隔开的,这是Qt提供给我们的,在帮助文档中可以看到。
我们需要一个每次只能输入一个或者一组快捷键的编辑框。

customKeySequenceEdit.h

 1 #ifndef CUSTOMKEYSEQUENCEEDIT_H
 2 #define CUSTOMKEYSEQUENCEEDIT_H
 3 
 4 #include <QKeySequenceEdit>
 5 
 6 class CustomKeySequenceEdit : public QKeySequenceEdit
 7 {
 8     Q_OBJECT
 9 
10 public:
11     explicit CustomKeySequenceEdit(QWidget *parent = nullptr);
12 
13 protected:
14     void keyPressEvent(QKeyEvent *event) override;
15 };
16 
17 #endif // CUSTOMKEYSEQUENCEEDIT_H

customKeySequenceEdit.cpp

 1 #include "customKeySequenceEdit.h"
 2 #include <QDebug>
 3 #include <QKeyEvent>
 4 
 5 CustomKeySequenceEdit::CustomKeySequenceEdit(QWidget *parent)
 6     : QKeySequenceEdit(parent)
 7 {
 8 //    this->setStyleSheet("QLineEdit{qproperty-alignment:AlignHCenter;}"); //设置文字居中
 9 }
10 
11 void CustomKeySequenceEdit::keyPressEvent(QKeyEvent *event)
12 {
13     if (event->key() == Qt::Key_Backspace)
14     {
15         this->clear();
16     }
17     else
18     {
19         QKeySequenceEdit::keyPressEvent(event);
20         QString strKeySequence = keySequence().toString().split(",").first();
21         QKeySequence seq(QKeySequence::fromString(strKeySequence));
22         setKeySequence(seq);
23     }
24 
25     emit editingFinished();
26 }

 这个是提升为我们自定义的CustomKeySequenceEdit控件
widget.h

 1 #ifndef WIDGET_H
 2 #define WIDGET_H
 3 
 4 #include "qxtglobalshortcut.h"
 5 
 6 #include <QWidget>
 7 
 8 QT_BEGIN_NAMESPACE
 9 namespace Ui { class Widget; }
10 QT_END_NAMESPACE
11 
12 class Widget : public QWidget
13 {
14     Q_OBJECT
15 
16 public:
17     Widget(QWidget *parent = nullptr);
18     ~Widget();
19 
20 private:
21     Ui::Widget *ui;
22     QxtGlobalShortcut *m_hotkey;
23     int m_activedNum;
24 };
25 #endif // WIDGET_H

widget.cpp

 1 #include "widget.h"
 2 #include "ui_widget.h"
 3 #include "customKeySequenceEdit.h"
 4 
 5 #include <QDebug>
 6 #include <QMessageBox>
 7 
 8 Widget::Widget(QWidget *parent)
 9     : QWidget(parent)
10     , ui(new Ui::Widget)
11     , m_hotkey(new QxtGlobalShortcut(this))
12     , m_activedNum(0)
13 {
14     ui->setupUi(this);
15     ui->label->clear();
16 
17     connect(ui->keySequenceEdit, &CustomKeySequenceEdit::editingFinished, this, [&](){
18          m_activedNum = 0;
19          ui->label->clear();
20 
21         if (m_hotkey->setShortcut(ui->keySequenceEdit->keySequence()))
22         {
23               qDebug() << "hot key is register sucess!";
24         }
25         else
26         {
27             if (!ui->keySequenceEdit->keySequence().isEmpty())
28                 qDebug() << "hot key is register failed!";
29         }
30     });
31 
32     connect(this->m_hotkey, &QxtGlobalShortcut::activated, [&](){
33         ++m_activedNum;
34         QString str = QString("shutcuts %1 actived %2 times").arg(ui->keySequenceEdit->keySequence().toString()).arg(m_activedNum);
35         ui->label->setText(str);
36     });
37 }
38 
39 Widget::~Widget()
40 {
41     delete ui;
42 }