Qt实现全局快捷键

实现思路

使用 Windows API 在 Qt 应用程序中注册全局快捷键，使得用户无论在何种情况下都能通过特定的键组合来控制某些功能（例如音乐播放控制）。通过响应消息机制与系统托盘图标结合，提供用户友好的交互界面。

实现步骤

1. 创建 Qt 应用程序

• 使用 Qt Creator 创建一个新的 Qt Widgets 应用程序项目。

2. 引入必要的头文件

在主窗口的 .cpp 文件中引入以下头文件：

#include <QApplication>
#include <QSystemTrayIcon>
#include <QMenu>
#include <QAction>
#include <QWidget>
#include <QMessageBox>
#include <windows.h>
#include <QDebug>

3. 创建主窗口类

继承自 QWidget，在类中添加系统托盘图标、快捷键注册和事件处理的相关代码。

4. 初始化系统托盘图标

在构造函数中，创建并设置系统托盘图标及其上下文菜单，添加退出程序的选项：

QSystemTrayIcon trayIcon;
QMenu *menu = new QMenu();
QAction *exitAction = menu->addAction("Exit");
QObject::connect(exitAction, &QAction::triggered, qApp, &QApplication::quit);
trayIcon.setContextMenu(menu);
trayIcon.setVisible(true);

5. 注册全局快捷键

使用 Windows API 的 RegisterHotKey 函数来注册需要的全局快捷键。在构造函数中执行以下代码：

RegisterHotKey(reinterpret_cast<HWND>(this->winId()), 1, MOD_CONTROL, VK_LEFT);  // Ctrl + Left
RegisterHotKey(reinterpret_cast<HWND>(this->winId()), 2, MOD_CONTROL, VK_RIGHT); // Ctrl + Right
RegisterHotKey(reinterpret_cast<HWND>(this->winId()), 3, MOD_CONTROL, VK_SPACE); // Ctrl + Space

6. 处理系统托盘图标的点击事件

使用信号和槽机制连接托盘图标的点击事件，提供用户反馈或打开/关闭主窗口的功能。

7. 实现 nativeEvent 方法

重写 nativeEvent 方法以处理 Windows 消息，捕获 WM_HOTKEY 消息并根据 wParam 值调用相应的功能（如上一曲、下一曲、播放/暂停）：

bool nativeEvent(const QByteArray &eventType, void *message, long *result) override {
    MSG* msg = reinterpret_cast<MSG*>(message);
    if (msg->message == WM_HOTKEY) {
        switch (msg->wParam) {
            case 1: // Ctrl + Left
                previousTrack();
                break;
            case 2: // Ctrl + Right
                nextTrack();
                break;
            case 3: // Ctrl + Space
                playPauseTrack();
                break;
        }
        return true; // 表示事件已处理
    }
    return QWidget::nativeEvent(eventType, message, result); // 传递给基类处理
}

8. 实现快捷键对应的功能

定义槽函数，例如 previousTrack()、nextTrack()、playPauseTrack()，在其中实现具体的操作，比如显示消息框或控制实际的音乐播放逻辑。

9. 清理资源

在应用程序退出时，确保注销全局热键（可在适当位置调用 UnregisterHotKey，如在析构函数或关闭事件处理函数中）：

UnregisterHotKey(reinterpret_cast<HWND>(this->winId()), 1);
UnregisterHotKey(reinterpret_cast<HWND>(this->winId()), 2);
UnregisterHotKey(reinterpret_cast<HWND>(this->winId()), 3);

10. 运行和测试

编译并运行应用程序，确保热键功能工作正常，托盘图标能够响应点击事件。

 

完整案例代码：

#include <QApplication>
#include <QSystemTrayIcon>
#include <QMenu>
#include <QAction>
#include <QWidget>
#include <QMessageBox>
#include <windows.h>
#include <QDebug>

class MusicControlApp : public QWidget {
public:
    MusicControlApp() {
        // 创建系统托盘图标
        trayIcon.setIcon(QIcon(":/Image/QQ图标.png"));
        trayIcon.setVisible(true);

        // 创建上下文菜单
        QMenu *menu = new QMenu();
        QAction *exitAction = menu->addAction("Exit");
        QObject::connect(exitAction, &QAction::triggered, qApp, &QApplication::quit);
        trayIcon.setContextMenu(menu);

        // 注册全局快捷键
        RegisterHotKey(reinterpret_cast<HWND>(this->winId()), 1, MOD_CONTROL, VK_LEFT);  // Ctrl + Left
        RegisterHotKey(reinterpret_cast<HWND>(this->winId()), 2, MOD_CONTROL, VK_RIGHT); // Ctrl + Right
        RegisterHotKey(reinterpret_cast<HWND>(this->winId()), 3, MOD_CONTROL, VK_SPACE); // Ctrl + Space

        // 处理托盘图标的点击事件
        QObject::connect(&trayIcon, &QSystemTrayIcon::activated, [&](QSystemTrayIcon::ActivationReason reason) {
            if (reason == QSystemTrayIcon::Trigger) {
                QMessageBox::information(nullptr, "Tray Icon Clicked", "You clicked the tray icon.");
            }
        });

        // 显示窗口
        this->setWindowTitle("Music Control App");
        this->resize(200, 100);
        this->show();
    }

protected:
    bool nativeEvent(const QByteArray &eventType, void *message, long *result) override {
        MSG* msg = reinterpret_cast<MSG*>(message);
        if (msg->message == WM_HOTKEY) {
            switch (msg->wParam) {
                case 1: // Ctrl + Left
                    previousTrack();
                    break;
                case 2: // Ctrl + Right
                    nextTrack();
                    break;
                case 3: // Ctrl + Space
                    playPauseTrack();
                    break;
            }
            return true; // 表示我们已经处理了这个事件
        }
        return QWidget::nativeEvent(eventType, message, result); // 传递给基类处理
    }

private slots:
    void previousTrack() {
        QMessageBox::information(nullptr, "Previous Track", "Previous track action triggered.");
        // 这里添加上一曲的实际功能代码
    }

    void nextTrack() {
        QMessageBox::information(nullptr, "Next Track", "Next track action triggered.");
        // 这里添加下一曲的实际功能代码
    }

    void playPauseTrack() {
        QMessageBox::information(nullptr, "Play/Pause", "Play/Pause action triggered.");
        // 这里添加播放/暂停的实际功能代码
    }

private:
    QSystemTrayIcon trayIcon;
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    app.setQuitOnLastWindowClosed(false);
    MusicControlApp musicApp; // 创建音乐控制应用实例
    return app.exec();
}