Linux下从X11按键码获取对应按键名称（XGrabKey）

嘿，这个问题我刚好熟！在X11环境下要从捕获的按键码拿到对应的按键名称，其实就是把硬件相关的keycode（按键码）转成逻辑层面的keysym（按键符号），再把keysym转成字符串就行啦。具体怎么实现，我给你一步步捋清楚：

首先得明确：X11里的按键码是和硬件绑定的数值，同一个按键在不同键盘上的keycode可能不一样；而keysym是统一的逻辑按键标识，比如'P'对应的keysym是XK_P，这才是我们要用来转名称的关键。

具体实现步骤 #

1. 把按键码转成按键符号（Keysym） #

推荐用XkbKeycodeToKeysym()这个函数，它能自动适配当前的键盘布局，比老的XLookupKeysym()靠谱多了（尤其是处理多语言布局的场景）。它的函数原型是：

KeySym XkbKeycodeToKeysym(Display *dpy, KeyCode keycode, int group, int level);

几个参数的意思：

• dpy：就是你用QX11Info::display()拿到的X11显示连接
• keycode：你捕获到的那个无符号按键码
• group：键盘布局组，一般传0就好（对应默认布局）
• level：按键层级，0是普通状态，1是Shift按下的状态——这个得根据你捕获到的modifier来调整哦

2. 把按键符号转成字符串 #

用XKeysymToString()函数就行，它能直接把Keysym转成对应的字符串，比如XK_P会直接返回"P"。函数原型：

char *XKeysymToString(KeySym keysym);

整合到你的代码里 #

比如你可以在事件处理的逻辑里加这段代码：

#include <xcb/xcb.h>
#include <X11/Xlib.h>
#include <X11/Xutil.h>
#include <X11/XKBlib.h> // 别忘了加这个头文件，不然用不了Xkb的函数
#include <QtX11Extras/QX11Info>
#include <QDebug>

// 假设你已经拿到了捕获到的keycode和modifiers
void EventFilter::handleKeyPress(unsigned int keycode, unsigned int modifiers) {
    Display *display = QX11Info::display();
    int level = 0;
    // 判断Shift是否按下，调整按键层级
    if (modifiers & ShiftMask) {
        level = 1;
    }
    // 把keycode转成keysym
    KeySym keysym = XkbKeycodeToKeysym(display, keycode, 0, level);
    // 把keysym转成按键名称字符串
    char *keyName = XKeysymToString(keysym);
    if (keyName != nullptr) {
        // 这里就拿到你要的按键名称啦！比如按下P时，keyName就是"P"
        qDebug() << "按下的按键：" << keyName;
        // 注意：XKeysymToString返回的字符串不用手动释放，Xlib会自己管理内存
    } else {
        qDebug() << "无法识别的按键";
    }
}

几个要注意的小细节 #

• 编译的时候要链接XKB库哦，如果你用Qt的.pro文件，记得加上LIBS += -lX11 -lXkbfile；如果是其他构建系统，也要对应加上链接参数
• 对于F1、Ctrl、Alt这类特殊按键，XKeysymToString()也能返回对应的名称，比如"F1"、"Control_L"、"Alt_R"
• 如果你的程序要支持多键盘布局切换，可以用XkbGetState()获取当前活跃的布局组，再传给XkbKeycodeToKeysym()的group参数

内容的提问来源于stack exchange，提问作者GUI-Novice