ImGui项目如何实现动态识别任意输入的自定义按键绑定功能

不需要枚举所有VK键码写冗长判断，直接基于ImGui自带的输入IO接口就能实现全输入捕获，逻辑非常轻量：

核心原理是ImGui每帧都会自动收集当前所有键盘、鼠标的按下状态，存在ImGuiIO结构体里，你不需要自己对接底层Win32消息、也不需要预定义支持的按键列表，只要在绑定激活的帧里扫描所有输入状态，抓到第一个按下的键存下来即可。

可直接复用的实现代码 #

先补全你示例里缺失的捕获逻辑，注意加了首帧跳过处理，避免用户点击按钮触发绑定的那次鼠标左键被误录为绑定键：

#include <windows.h>
// 工具函数：把VK码转成系统本地化的按键名，不需要自己硬编码键名
const char* GetKeyName(int vk_code) {
    static char key_name[32] = {0};
    UINT scan_code = MapVirtualKeyA(vk_code, MAPVK_VK_TO_VSC);
    // 处理扩展键（比如鼠标侧键、小键盘按键）
    if (vk_code >= VK_XBUTTON1 || vk_code == VK_INSERT || vk_code == VK_DELETE) {
        scan_code |= 0x100;
    }
    GetKeyNameTextA(scan_code << 16, key_name, sizeof(key_name));
    return key_name;
}

// 绑定控件逻辑
const char* cbind0 = "none";
static bool bbind0 = false;
static int ibind0 = 0;
static bool capture_started = false;

if (ImGui::Button(cbind0, ImVec2(120, 30))) {
    bbind0 = true;
    capture_started = false;
    cbind0 = "按任意键...";
}

if (bbind0) {
    ImGuiIO& io = ImGui::GetIO();
    // 第一帧清空当前已按下的输入状态，跳过触发绑定的点击事件
    if (!capture_started) {
        capture_started = true;
        memset(io.KeysDown, 0, sizeof(io.KeysDown));
        memset(io.MouseDown, 0, sizeof(io.MouseDown));
        io.MouseWheel = 0;
    } else {
        int captured = 0;
        // 扫描所有键盘按键，覆盖标准VK码全范围
        for (int vk = VK_BACK; vk <= VK_OEM_CLEAR; vk++) {
            if (ImGui::IsKeyPressed(vk, false)) {
                captured = vk;
                break;
            }
        }
        // 键盘无输入再扫描鼠标按键（左/右/中/两个侧键）
        if (!captured) {
            const int mouse_vk_map[] = {VK_LBUTTON, VK_RBUTTON, VK_MBUTTON, VK_XBUTTON1, VK_XBUTTON2};
            for (int mouse_idx = 0; mouse_idx < 5; mouse_idx++) {
                if (ImGui::IsMouseClicked(mouse_idx, false)) {
                    captured = mouse_vk_map[mouse_idx];
                    break;
                }
            }
        }
        // 检测到有效输入就保存，退出捕获状态
        if (captured && captured != VK_ESCAPE) {
            ibind0 = captured;
            bbind0 = false;
            cbind0 = GetKeyName(ibind0);
        }
        // 按ESC取消本次绑定
        if (captured == VK_ESCAPE) {
            bbind0 = false;
            cbind0 = ibind0 ? GetKeyName(ibind0) : "无";
        }
    }
}

使用说明 #

• 存下来的ibind0是标准Windows虚拟键码，和你原来用的GetAsyncKeyState完全兼容，不需要做任何转换，直接传参就能判断按键状态。
• 这套逻辑能自动识别所有标准键盘按键、鼠标5个按键，包括特殊功能键、媒体键，不会出现漏键的问题，代码量比枚举所有键写if判断少非常多。
• 如果需要支持手柄输入，只要在扫描逻辑里加一段遍历io.NavInputs的判断，给手柄按键分配大于0xFF的自定义键值即可，扩展成本很低。
• 捕获状态下ImGui不会响应其他快捷键，避免绑定过程中误触其他控件。

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