挂钩Keydown事件时如何避免重复触发？实现单次调用效果

这个问题我之前也碰到过，系统默认的键盘自动重复机制就是罪魁祸首——当你按住按键不放时，系统会持续发送WM_KEYDOWN消息，直到你松开按键，这是Windows的默认行为。要让WM_KEYDOWN像WM_KEYUP一样只触发一次，有两种实用的解决思路：

方法一：利用系统提供的重复事件标志 #

Windows在KBDLLHOOKSTRUCT结构体的flags字段里提供了LLKHF_REPEAT标志，如果这个标志被设置，说明当前的WM_KEYDOWN是重复触发的事件，我们直接忽略它就行。

修改后的回调代码如下：

#include <iostream>
#include <windows.h>

using namespace std;

LRESULT CALLBACK KeyboardProc(int nCode, WPARAM wParam, LPARAM lParam) { 
    // 只有当nCode >= 0时，钩子事件才有效
    if (nCode >= 0) { 
        PKBDLLHOOKSTRUCT pKey = reinterpret_cast<PKBDLLHOOKSTRUCT>(lParam); 
        if (wParam == WM_KEYDOWN) { 
            // 检查是否是重复触发的按键事件
            if (!(pKey->flags & LLKHF_REPEAT)) {
                int key = pKey->vkCode; 
                cout << "首次按下按键：" << key << endl; 
            }
        } 
        if (wParam == WM_KEYUP) { 
            int key = pKey->vkCode; 
            cout << "松开按键：" << key << endl; 
        }
    }
    // 务必调用下一个钩子，否则会影响系统其他键盘事件的处理
    return CallNextHookEx(NULL, nCode, wParam, lParam); 
}

方法二：手动维护按键状态 #

如果你想更灵活地控制按键触发逻辑，可以自己维护一个数组记录每个按键的按下状态：当WM_KEYDOWN触发时，先检查按键是否已经被标记为“按下”，如果没有才处理事件并标记状态；当WM_KEYUP触发时，再把状态重置为“未按下”。

示例代码：

#include <iostream>
#include <windows.h>
#include <array>

using namespace std;

// 用数组记录按键状态：true=已按下，false=未按下（虚拟键码范围大多在0-255）
array<bool, 256> keyStates = {false};

LRESULT CALLBACK KeyboardProc(int nCode, WPARAM wParam, LPARAM lParam) { 
    if (nCode >= 0) {
        PKBDLLHOOKSTRUCT pKey = reinterpret_cast<PKBDLLHOOKSTRUCT>(lParam); 
        int key = pKey->vkCode;
        
        if (wParam == WM_KEYDOWN) { 
            // 只有当按键未被标记为按下时，才处理事件
            if (!keyStates[key]) { 
                keyStates[key] = true;
                cout << "首次按下按键：" << key << endl; 
            }
        } 
        if (wParam == WM_KEYUP) { 
            // 松开按键时重置状态
            keyStates[key] = false;
            cout << "松开按键：" << key << endl; 
        }
    }
    return CallNextHookEx(NULL, nCode, wParam, lParam); 
}

一些注意事项 #

• 钩子回调函数里尽量不要做耗时操作，因为钩子是在系统线程上下文执行的，卡壳会影响整个系统的响应。
• 如果需要拦截某个按键的事件，可以在处理后返回非0值，但要谨慎使用，避免破坏系统正常的键盘输入。
• 方法一依赖系统的标志位，实现简单；方法二更灵活，适合需要自定义按键状态逻辑的场景。

内容的提问来源于stack exchange，提问作者Demacian