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 键时退出消息循环。
- SetHook 函数:
- 该函数使用 SetWindowsHookEx 函数安装键盘钩子。WH_KEYBOARD_LL 表示低级键盘钩子,它可以捕获全局键盘事件。
- GetModuleHandle(NULL) 获取当前模块的句柄,并将其传递给钩子函数。
- Unhook 函数:
- 在程序退出时,调用 UnhookWindowsHookEx 函数卸载钩子,避免程序退出后钩子仍然生效。
- main 函数:
- 首先调用 SetHook 函数安装键盘钩子。
- 然后进入消息循环,保持程序运行,并在消息循环中响应键盘事件。
- 当消息循环退出时(例如按下 Esc 键),调用 Unhook 函数卸载钩子。