项目介绍:
该项目实现了一个基于 Qt 框架的全局键盘和鼠标事件监控工具,主要功能包括:
- 实时监控全局键盘事件:捕获并显示所有键盘按键,并将按键的虚拟键码转为键名显示。
- 实时监控全局鼠标事件:捕获并显示鼠标左键、右键和中键点击事件及其位置。
- 系统托盘功能:主窗口可以最小化到系统托盘,提供了“显示”和“退出”功能。
- 事件显示:所有捕获的事件信息都会实时显示在主窗口的
plainTextEdit
中。
主要文件
mainwindow.h
和mainwindow.cpp
:定义和实现主窗口类MainWindow
,用于显示捕获的事件信息和控制程序的主界面。mhook.h
和mhook.cpp
:定义和实现全局键盘和鼠标钩子类MyHook
,实现事件的捕获、区分、翻译和信号传递。
功能分解
- 全局钩子捕获事件:利用 Windows API 实现键盘和鼠标钩子,通过
MyHook
类进行封装,捕获系统中的键盘和鼠标事件。 - 信号槽机制:键盘和鼠标事件捕获后,通过 Qt 信号槽机制传递到
MainWindow
,从而在plainTextEdit
中显示。 - 托盘图标管理:托盘图标和菜单使得程序可以在系统托盘中最小化和恢复显示。
- 键码翻译:使用键码转换函数
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
的实现中包含键盘和鼠标钩子的安装、卸载、事件捕获及信号发送逻辑。
关键代码解释
- 单例模式:
instance
方法创建并返回唯一的MyHook
实例。 - 钩子安装和卸载:
installHook
和unInstallHook
方法调用 Windows APISetWindowsHookEx
和UnhookWindowsHookEx
实现钩子的安装和卸载。 - 键盘和鼠标事件捕获:定义
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_OBJECTpublic: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
的实现包括系统托盘、事件显示和键码翻译逻辑。
关键代码解释
- 系统托盘:
initTrayIcon
方法初始化系统托盘图标和菜单。 - 键盘事件槽:
onKeyEventReceived
将键码翻译并显示到plainTextEdit
。 - 鼠标事件槽:
onMouseEventReceived
显示鼠标按键和位置。 - 键码翻译:
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);}
}
项目运行
- 运行后,主窗口会捕获并显示键盘和鼠标事件,支持托盘最小化,并且能够通过系统托盘图标显示或退出。
- 应用场景:适用于事件监控、快捷键监控等场景。