基于Qt/C++全局键盘和鼠标事件监控工具

项目介绍：

该项目实现了一个基于 Qt 框架的全局键盘和鼠标事件监控工具，主要功能包括：

1. 实时监控全局键盘事件：捕获并显示所有键盘按键，并将按键的虚拟键码转为键名显示。
2. 实时监控全局鼠标事件：捕获并显示鼠标左键、右键和中键点击事件及其位置。
3. 系统托盘功能：主窗口可以最小化到系统托盘，提供了"显示"和"退出"功能。
4. 事件显示 ：所有捕获的事件信息都会实时显示在主窗口的 plainTextEdit 中。

主要文件

• mainwindow.h 和 mainwindow.cpp：定义和实现主窗口类 MainWindow，用于显示捕获的事件信息和控制程序的主界面。
• mhook.h 和 mhook.cpp：定义和实现全局键盘和鼠标钩子类 MyHook，实现事件的捕获、区分、翻译和信号传递。

功能分解

1. 全局钩子捕获事件 ：利用 Windows API 实现键盘和鼠标钩子，通过 MyHook 类进行封装，捕获系统中的键盘和鼠标事件。
2. 信号槽机制 ：键盘和鼠标事件捕获后，通过 Qt 信号槽机制传递到 MainWindow，从而在 plainTextEdit 中显示。
3. 托盘图标管理：托盘图标和菜单使得程序可以在系统托盘中最小化和恢复显示。
4. 键码翻译 ：使用键码转换函数 translateKey 将虚拟键码转换为键名，方便用户阅读。

---

文件和代码讲解

mhook.h：钩子类定义

此头文件定义了 MyHook 类，它负责全局键盘和鼠标事件的捕获。

#ifndef MHOOK_H
#define MHOOK_H

#include <Windows.h>
#include <QObject>
#include <QMessageBox>
#include <QDebug>

// 用于中文字符显示的宏定义
#define tc(a) QString::fromLocal8Bit(a) 

// 钩子类 MyHook 定义
class MyHook : public QObject
{
    Q_OBJECT
public:
    // 定义捕获模式的枚举
    enum Model
    {
        eNull = 0,         // 空模式，不捕获
        eKey = 1,          // 键盘钩子模式
        eMouse = 2,        // 鼠标钩子模式
        eMouseKey = 3      // 键盘和鼠标钩子模式
    } mModel;

    // 单例模式：获得唯一实例
    static MyHook* instance();

    // 安装和卸载钩子函数
    void installHook(Model model);
    void unInstallHook(Model model);

private:
    MyHook(); // 私有构造函数
    void showError(const QString& message); // 异常提示方法

signals:
    void keyEventReceived(int vkCode);                // 键盘事件信号
    void mouseEventReceived(int x, int y, QString button);  // 鼠标事件信号，增加按钮信息
};

#endif // MHOOK_H

mhook.cpp：钩子类实现

MyHook 的实现中包含键盘和鼠标钩子的安装、卸载、事件捕获及信号发送逻辑。

关键代码解释

1. 单例模式 ：instance 方法创建并返回唯一的 MyHook 实例。
2. 钩子安装和卸载 ：installHook 和 unInstallHook 方法调用 Windows API SetWindowsHookEx 和 UnhookWindowsHookEx 实现钩子的安装和卸载。
3. 键盘和鼠标事件捕获 ：定义 keyProc 和 mouseProc 回调函数，通过 WPARAM 区分不同的按键和鼠标键。

#include "mhook.h"

// 静态变量定义
static HHOOK keyHook = nullptr, mouseHook = nullptr;
static MyHook* hookClass = nullptr;

// 键盘钩子处理函数
LRESULT CALLBACK keyProc(int nCode, WPARAM wParam, LPARAM lParam)
{
    if (!hookClass)
        return CallNextHookEx(keyHook, nCode, wParam, lParam);

    if (wParam == WM_KEYDOWN) // 键盘按下事件
    {
        KBDLLHOOKSTRUCT* pkbhs = (KBDLLHOOKSTRUCT*)lParam;
        
        // 触发信号传递键码
        emit hookClass->keyEventReceived(pkbhs->vkCode);
    }
    
    return CallNextHookEx(keyHook, nCode, wParam, lParam); // 继续传递事件队列
}

// 鼠标钩子处理函数
LRESULT CALLBACK mouseProc(int nCode, WPARAM wParam, LPARAM lParam)
{
    if (!hookClass)
        return CallNextHookEx(mouseHook, nCode, wParam, lParam);

    MOUSEHOOKSTRUCT* mhookstruct = (MOUSEHOOKSTRUCT*)lParam;
    POINT pt = mhookstruct->pt; // 获取鼠标坐标

    // 根据 WPARAM 区分鼠标键类型
    if (wParam == WM_LBUTTONDOWN)
        emit hookClass->mouseEventReceived(pt.x, pt.y, tc("左键"));
    else if (wParam == WM_RBUTTONDOWN)
        emit hookClass->mouseEventReceived(pt.x, pt.y, tc("右键"));
    else if (wParam == WM_MBUTTONDOWN)
        emit hookClass->mouseEventReceived(pt.x, pt.y, tc("中键"));
    
    return CallNextHookEx(mouseHook, nCode, wParam, lParam); // 继续传递事件队列
}

---

mainwindow.h：主窗口类定义

定义 MainWindow 类，主要负责接收事件信号并显示。

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QSystemTrayIcon>
#include "mhook.h"

class MainWindow : public QMainWindow
{
    Q_OBJECT

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

protected:
    void closeEvent(QCloseEvent *event) override; // 重写关闭事件

private slots:
    void onKeyEventReceived(int vkCode); // 键盘事件处理槽
    void onMouseEventReceived(int x, int y, QString button); // 鼠标事件处理槽
    void showMainWindow(); // 显示主窗口
    void exitApplication(); // 退出应用程序

private:
    QSystemTrayIcon *trayIcon;
    QMenu *trayMenu;

    QString translateKey(int vkCode); // 键码翻译函数
    void initTrayIcon(); // 初始化系统托盘
};

#endif // MAINWINDOW_H

mainwindow.cpp：主窗口类实现

MainWindow 的实现包括系统托盘、事件显示和键码翻译逻辑。

关键代码解释

1. 系统托盘 ：initTrayIcon 方法初始化系统托盘图标和菜单。
2. 键盘事件槽 ：onKeyEventReceived 将键码翻译并显示到 plainTextEdit。
3. 鼠标事件槽 ：onMouseEventReceived 显示鼠标按键和位置。
4. 键码翻译 ：translateKey 将键码转换为易读的按键名称。

#include "mainwindow.h"
#include <QCloseEvent>
#include <QMenu>

// 构造函数
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent), trayIcon(new QSystemTrayIcon(this)), trayMenu(new QMenu(this))
{
    ui->setupUi(this);
    
    // 初始化系统托盘
    initTrayIcon();

    // 连接钩子类的信号到槽函数
    MyHook *hook = MyHook::instance();
    connect(hook, &MyHook::keyEventReceived, this, &MainWindow::onKeyEventReceived);
    connect(hook, &MyHook::mouseEventReceived, this, &MainWindow::onMouseEventReceived);

    // 安装键盘和鼠标钩子
    hook->installHook(MyHook::eMouseKey);
}

// 键盘事件槽函数
void MainWindow::onKeyEventReceived(int vkCode)
{
    QString keyName = translateKey(vkCode);
    ui->plainTextEdit->appendPlainText(tc("键盘事件: 按键 - ") + keyName);
}

// 鼠标事件槽函数
void MainWindow::onMouseEventReceived(int x, int y, QString button)
{
    ui->plainTextEdit->appendPlainText(tc("鼠标事件: ") + button + tc("点击位置 (") + QString::number(x) + ", " + QString::number(y) + ")");
}

// 键码翻译函数
QString MainWindow::translateKey(int vkCode)
{
    switch (

vkCode)
    {
        case 0x41: return "A";
        case 0x42: return "B";
        case VK_RETURN: return tc("回车");
        case VK_SPACE: return tc("空格");
        // 完整键码翻译略
        default: return QString("0x%1").arg(vkCode, 0, 16);
    }
}

---

项目运行

• 运行后，主窗口会捕获并显示键盘和鼠标事件，支持托盘最小化，并且能够通过系统托盘图标显示或退出。
• 应用场景：适用于事件监控、快捷键监控等场景。