Qt全局热键之使用QxtGlobalShortcut实现

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

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

目前有两个的多平台（windows、linux和mac平台）上能用较稳定的开源库
QxtGlobalShortcut（Qt5版本是QxtGlobalShortcut5）和QHotkey

本文就介绍QxtGlobalShortcut在Qt5中的应用，看看最简单使用步骤和例子：
三步曲：

1. 首先是下载https://github.com/ddqd/qxtglobalshortcut5
2. 把qxtglobalshortcut5文件放在项目目录下，在项目.pro加入一句，include(qxtglobalshortcut5-master/qxt.pri)（这个具体的目录名称，自己可以修改）
3. 使用，包含头文件#include “qxtglobalshortcut.h”

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QDebug>
#include "qxtglobalshortcut.h"
MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    QxtGlobalShortcut *shortcut = new QxtGlobalShortcut(this);
    if(shortcut->setShortcut(QKeySequence("Shift+1")))
    {
        connect(shortcut, &QxtGlobalShortcut::activated,
            [=]() {qDebug() << "shortcut activated";});
    }
    else
    {
        qDebug()<<"快捷键已占用";
    }
}

这些参考：Qt 全局热键 QxtGlobalShortcut5

说明：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提供给我们的，在帮助文档中可以看到。
我们需要一个每次只能输入一个或者一组快捷键的编辑框。
参考：QT QKeySequenceEdit限定只接收一个按键
customKeySequenceEdit.h

#ifndef CUSTOMKEYSEQUENCEEDIT_H
#define CUSTOMKEYSEQUENCEEDIT_H

#include <QKeySequenceEdit>

class CustomKeySequenceEdit : public QKeySequenceEdit
{
    Q_OBJECT

public:
    explicit CustomKeySequenceEdit(QWidget *parent = nullptr);

protected:
    void keyPressEvent(QKeyEvent *event) override;
};

#endif // CUSTOMKEYSEQUENCEEDIT_H

customKeySequenceEdit.cpp

#include "customKeySequenceEdit.h"
#include <QDebug>
#include <QKeyEvent>

CustomKeySequenceEdit::CustomKeySequenceEdit(QWidget *parent)
    : QKeySequenceEdit(parent)
{
//    this->setStyleSheet("QLineEdit{qproperty-alignment:AlignHCenter;}"); //设置文字居中
}

void CustomKeySequenceEdit::keyPressEvent(QKeyEvent *event)
{
    if (event->key() == Qt::Key_Backspace)
    {
        this->clear();
    }
    else
    {
        QKeySequenceEdit::keyPressEvent(event);
        QString strKeySequence = keySequence().toString().split(",").first();
        QKeySequence seq(QKeySequence::fromString(strKeySequence));
        setKeySequence(seq);
    }

    emit editingFinished();
}

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

#ifndef WIDGET_H
#define WIDGET_H

#include "qxtglobalshortcut.h"

#include <QWidget>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();

private:
    Ui::Widget *ui;
    QxtGlobalShortcut *m_hotkey;
    int m_activedNum;
};
#endif // WIDGET_H

widget.cpp

#include "widget.h"
#include "ui_widget.h"
#include "customKeySequenceEdit.h"

#include <QDebug>
#include <QMessageBox>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
    , m_hotkey(new QxtGlobalShortcut(this))
    , m_activedNum(0)
{
    ui->setupUi(this);
    ui->label->clear();

    connect(ui->keySequenceEdit, &CustomKeySequenceEdit::editingFinished, this, [&](){
         m_activedNum = 0;
         ui->label->clear();

        if (m_hotkey->setShortcut(ui->keySequenceEdit->keySequence()))
        {
              qDebug() << "hot key is register sucess!";
        }
        else
        {
            if (!ui->keySequenceEdit->keySequence().isEmpty())
                qDebug() << "hot key is register failed!";
        }
    });

    connect(this->m_hotkey, &QxtGlobalShortcut::activated, [&](){
        ++m_activedNum;
        QString str = QString("shutcuts %1 actived %2 times").arg(ui->keySequenceEdit->keySequence().toString()).arg(m_activedNum);
        ui->label->setText(str);
    });
}

Widget::~Widget()
{
    delete ui;
}

全部代码在此，从例子中看到，这个全局快捷键还是很容易使用的。

参考：
Qt 全局热键 QxtGlobalShortcut5
QT QKeySequenceEdit限定只接收一个按键
Qt 全局热键 QxtGlobalShortcut 分析与使用举例
Qt注册全局热键
Qt学习笔记 QLineEdit文字居中