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

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;
}

代码说明

1. KeyboardProc 函数:

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

2. SetHook 函数:

• 该函数使用 SetWindowsHookEx 函数安装键盘钩子。WH_KEYBOARD_LL 表示低级键盘钩子，它可以捕获全局键盘事件。
• GetModuleHandle(NULL) 获取当前模块的句柄，并将其传递给钩子函数。

3. Unhook 函数:

• 在程序退出时，调用 UnhookWindowsHookEx 函数卸载钩子，避免程序退出后钩子仍然生效。

4. main 函数:

• 首先调用 SetHook 函数安装键盘钩子。
• 然后进入消息循环，保持程序运行，并在消息循环中响应键盘事件。
• 当消息循环退出时（例如按下 Esc 键），调用 Unhook 函数卸载钩子。