力学笃行（五）Qt key绑定、钩子（hook）

Qt key绑定

1. Qt 按键绑定
- 1.1 主窗口或页面文件（如 QWidget, QMainWindow）
- 1.2 自定义控件或类
- 1.3 全局捕获按键
2. widows按键绑定

1. Qt 按键绑定

1.1 主窗口或页面文件（如 QWidget, QMainWindow）

常见使用场景: 在页面文件中处理按键事件通常是为了在整个窗口中捕获键盘输入。这可以通过重载 keyPressEvent() 或
installEventFilter() 来实现。
焦点要求: 确保窗口或页面拥有焦点，否则按键事件可能不会传递给该控件。

#include <QApplication>
#include <QMainWindow>
#include <QKeyEvent>
#include <QLabel>
#include <QVBoxLayout>
#include <QDebug>class MainWindow : public QMainWindow {Q_OBJECT
public:MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {// 设置一个简单的标签作为界面内容QLabel *label = new QLabel("Press Space or Esc key", this);label->setAlignment(Qt::AlignCenter);// 将标签设置为中心部件setCentralWidget(label);// 设置窗口标题setWindowTitle("Key Event Example");// 设置窗口大小resize(400, 300);}protected:// 重载 keyPressEvent 函数以处理按键事件void keyPressEvent(QKeyEvent *event) override {// 检查是否按下空格键if (event->key() == Qt::Key_Space) {qDebug() << "Space key pressed!";}// 检查是否按下 Esc 键else if (event->key() == Qt::Key_Escape) {qDebug() << "Escape key pressed!";close(); // 按下 Esc 键时关闭窗口}// 其他按键处理（可选）else {QMainWindow::keyPressEvent(event); // 调用基类的默认处理}}
};int main(int argc, char *argv[]) {QApplication app(argc, argv);// 创建主窗口实例MainWindow mainWindow;mainWindow.show();return app.exec();
}#include "main.moc"

1.2 自定义控件或类

说明: 如果你在自定义控件中处理按键事件，只需要确保该控件拥有焦点，或者通过事件过滤器捕获按键事件。你不必一定在页面文件中编写这些代码。
注意：自定义控件必须安装事件过滤器到主窗口，否则会出现监控不到按键的情况。
示例: 可以在自定义的类中安装事件过滤器，或重载 keyPressEvent()，以处理按键事件。

class CustomWidget : public QWidget {Q_OBJECT
public:CustomWidget(QWidget *parent = nullptr) : QWidget(parent) {}
protected:void keyPressEvent(QKeyEvent *event) override {if (event->key() == Qt::Key_Space) {qDebug() << "Space key pressed in CustomWidget!";}QWidget::keyPressEvent(event);}
};

说明	资源地址
单个按键示例类	https://download.csdn.net/download/qq_43572400/89649037
组合按键示例类	https://download.csdn.net/download/qq_43572400/89649064

具体应用代码

// 快捷键
keyEscHandler = new KeyEventHandler(Qt::Key_Escape, this);  // ESC键
connect(keyEscHandler, &KeyEventHandler::keyPressed, this, [&]() {// esc处理逻辑
});
this->installEventFilter(keyEscHandler);                    // 安装事件过滤器到主窗口（或其他感兴趣的对象）
keyLeftHandler = new KeyEventHandler(Qt::Key_Left, this);   // 左键
connect(keyLeftHandler, &KeyEventHandler::keyPressed,     this, [&](){// 单击逻辑
});
connect(keyLeftHandler, &KeyEventHandler::keyLongPressed, this, [&](){// 长按逻辑
});
connect(keyLeftHandler, &KeyEventHandler::keyReleased, this, [&](){// 释放逻辑
});
this->installEventFilter(keyLeftHandler);

1.3 全局捕获按键

说明: 如果你需要在应用程序的任何位置捕获按键事件，可以使用事件过滤器并将其安装到整个应用程序对象上。
实现: 将事件过滤器安装到 QApplication 对象上，这样你可以全局捕获按键事件。

class GlobalKeyHandler : public QObject {Q_OBJECT
public:bool eventFilter(QObject *obj, QEvent *event) override {if (event->type() == QEvent::KeyPress) {QKeyEvent *keyEvent = static_cast<QKeyEvent *>(event);if (keyEvent->key() == Qt::Key_Escape) {qDebug() << "Escape key pressed globally!";return true; // 阻止进一步传播}}return QObject::eventFilter(obj, event);}
};
// 在 main 函数中安装事件过滤器
int main(int argc, char *argv[]) {QApplication app(argc, argv);GlobalKeyHandler *handler = new GlobalKeyHandler();app.installEventFilter(handler);MainWindow mainWindow;mainWindow.show();return app.exec();
}

2. widows按键绑定

在 C++ 中，使用钩子（hook）技术可以全局拦截和处理键盘事件。通常我们使用 Windows API 来实现钩子机制，用于全局捕获键盘事件。以下是如何实现基于钩子的按键绑定示例代码，以及相关的说明和详细示例。

注意事项

钩子安装: 钩子（hook）可以全局捕获键盘事件，即使应用程序在后台也能捕获按键。
权限问题: 全局钩子需要有足够的权限才能安装成功。
调试: 由于钩子会全局捕获按键事件，调试时需要特别注意，避免导致系统失去响应。

#include <windows.h>
#include <iostream>HHOOK hKeyboardHook;// 钩子回调函数
LRESULT CALLBACK KeyboardProc(int nCode, WPARAM wParam, LPARAM lParam) {if (nCode >= 0) {// 检测按键按下事件if (wParam == WM_KEYDOWN || wParam == WM_SYSKEYDOWN) {KBDLLHOOKSTRUCT *pKeyBoard = (KBDLLHOOKSTRUCT *)lParam;int key = pKeyBoard->vkCode;// 检测空格键if (key == VK_SPACE) {std::cout << "Space key pressed!" << std::endl;}// 检测 Esc 键else if (key == VK_ESCAPE) {std::cout << "Escape key pressed!" << std::endl;PostQuitMessage(0);  // 退出消息循环}}}// 调用下一个钩子链中的钩子return CallNextHookEx(hKeyboardHook, nCode, wParam, lParam);
}// 安装钩子
void SetHook() {hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardProc, GetModuleHandle(NULL), 0);if (hKeyboardHook == NULL) {std::cerr << "Failed to install hook!" << std::endl;} else {std::cout << "Hook installed successfully!" << std::endl;}
}// 卸载钩子
void Unhook() {UnhookWindowsHookEx(hKeyboardHook);
}int main() {// 安装键盘钩子SetHook();// 消息循环，保持钩子活跃MSG msg;while (GetMessage(&msg, NULL, 0, 0)) {TranslateMessage(&msg);DispatchMessage(&msg);}// 程序退出时卸载钩子Unhook();return 0;
}

代码说明

KeyboardProc 函数:

这是一个键盘钩子的回调函数，用于处理键盘事件。函数参数中 nCode 表示钩子的事件代码，wParam 表示消息类型（如按下或释放键），lParam 包含按键的详细信息。
在 wParam == WM_KEYDOWN 时，表示按下了某个键。我们通过 KBDLLHOOKSTRUCT 结构体来获取具体的按键（如 VK_SPACE 表示空格键）。
如果检测到按下了空格键或 Esc 键，程序会输出对应的消息，并在按下 Esc 键时退出消息循环。