Xlib窗口管理器无法接收Xterm窗口ButtonPress事件的技术问询

我用Xlib开发了一款窗口管理器，原本通过处理ButtonPress事件为被点击的窗口设置InputFocus。但打开Xterm窗口后，点击它时收不到ButtonPress事件，也没法设置焦点，只能收到EnterWindowMask相关事件。我怀疑Xterm拦截了事件，不让它传到窗口管理器，但Mutter下运行Xterm时却能正常检测点击并设置焦点。想知道：

1. Mutter是怎么实现这一行为的？用了哪些机制在高层拦截处理输入事件，从而管理窗口焦点并处理应用窗口的按键按压？
2. 我的Xlib窗口管理器需要用哪些特定的Xlib或X Input Extension函数才能实现类似功能？

代码示例 #

#include <X11/Xlib.h>
#include <iostream>
#include <unordered_map>
#include "FrameWindow.h"

Display* display = nullptr;
std::unordered_map<Window, Window> frames;
std::unordered_map<Window, FrameWindow *> framesMap;

void handleButtonPress(const XButtonEvent event)
{
    if (frames.count(event.window)) {
        XSetInputFocus(display, event.window, RevertToPointerRoot, CurrentTime);
    }
  
}

void addWindowFrame(Window window, Bool isPreExisting)
{
  if (isPreExisting) {
    XWindowAttributes winAttrs;
    XGetWindowAttributes(display, window, &winAttrs);
    if (
      winAttrs.override_redirect
      || winAttrs.map_state != IsViewable
    ) {
      return;
    }

    XSetWindowBorderWidth(display, window, 0);
  }

  FrameWindow *frame = new FrameWindow(display, window);
  frames[window] = frame->frameWindow;
  framesMap[frame->frameWindow] = frame;

}

void handleMapRequest(const XMapRequestEvent event)
{
  addWindowFrame(event.window, false);
  XMapWindow(display, event.window);
}

int main() {
    display = XOpenDisplay(NULL);
    if (!display) {
        std::cerr << "Failed to open X display" << std::endl;
        return 1;
    }

    Window rootWindow = DefaultRootWindow(display);

    long events = SubstructureRedirectMask
                | SubstructureNotifyMask
                | StructureNotifyMask
                | ButtonPressMask;
    XSelectInput(display, rootWindow, events);

    XFlush(display);

    XEvent evt;
    while (true) {
        XNextEvent(display, &evt);
        switch (evt.type) {
            case CreateNotify:
                handleCreateNotify(evt.xcreatewindow);
                break;
            case ConfigureRequest:
                handleConfigureRequest(evt.xconfigurerequest);
                break;
            case ConfigureNotify:
                break;
            case MapRequest:
                handleMapRequest(display, evt.xmaprequest);
                break;
            case MapNotify:
                handleMapNotify(evt.xmap);
                break;
            case UnmapNotify:
                handleUnmapNotify(evt.xunmap);
                break;
            case ReparentNotify:
                handleReparentNotify(evt.xreparent);
                break;
            case Expose:
                handleButtonPress(evt.xexpose);
                break;
            case ButtonPress:
                handleButtonPress(evt.xbutton);
                break;
            case ButtonRelease:
                handleButtonRelease(evt.xbutton);
                break;
            case MotionNotify:
                handleMotionNotify(evt.xmotion);
                break;
            case DestroyNotify:
                handleDestroyNotify(evt.xdestroywindow);
                break;
        }
    }

    // Clean up and close the display
    XCloseDisplay(display);

    return 0;
}

为什么你的代码收不到Xterm的ButtonPress事件 #

Xterm这类终端程序会主动调用XGrabButton抓取鼠标按键事件，导致事件直接发送给Xterm进程，而不会传递到你监听的根窗口。这是X客户端抢占输入的标准手段。

Mutter的实现机制 #

Mutter作为现代合成窗口管理器，核心依赖X Input 2 (XI2) 扩展和合成层输入处理，具体机制包括：

• 原始事件拦截：通过XI2直接监听设备级的原始输入事件，绕过客户端的事件抓取，确保管理器能优先感知点击动作。
• 合成层输入路由：Mutter在自己的合成窗口层处理输入，通过XCompositeExtension获取窗口渲染数据的同时，直接处理输入事件，再决定是否向下传递给客户端。
• 动态抓取与释放：在需要时（比如窗口切换、点击桌面）临时全局抓取输入，处理完焦点逻辑后立即释放，避免影响客户端正常输入。
• 焦点状态主动维护：Mutter维护独立的焦点窗口列表，结合XI2事件和窗口状态变化，主动调用XSetInputFocus调整焦点，不受客户端事件拦截影响。

你的Xlib窗口管理器需要做的修改 #

1. 接入X Input 2 (XI2) 获取原始输入 #

XI2是绕过客户端事件抓取的核心，步骤如下：

• 检查并初始化XI2扩展：

#include <X11/extensions/XInput2.h>

// 在main函数中添加XI2初始化
int xi_opcode, event, error;
if (!XQueryExtension(display, "XInputExtension", &xi_opcode, &event, &error)) {
    std::cerr << "XInput2 not supported" << std::endl;
    return 1;
}

int major = 2, minor = 3;
if (XIQueryVersion(display, &major, &minor) != Success) {
    std::cerr << "Failed to get XI2 version" << std::endl;
    return 1;
}

// 选择监听原始按钮事件
XIEventMask mask;
mask.deviceid = XIAllDevices;
mask.mask_len = XIMaskLen(XI_LASTEVENT);
unsigned char* mask_data = new unsigned char[mask.mask_len];
memset(mask_data, 0, mask.mask_len);
XISetMask(mask_data, XI_RawButtonPress);
XISelectEvents(display, rootWindow, &mask, 1);
delete[] mask_data;

• 在事件循环中处理XI2事件：

while (true) {
    XNextEvent(display, &evt);
    // 先处理XI2通用事件
    if (evt.type == GenericEvent && evt.xgeneric.extension == xi_opcode) {
        XGenericEventCookie* cookie = &evt.xgeneric;
        if (XGetEventData(display, cookie) && cookie->evtype == XI_RawButtonPress) {
            XIRawEvent* raw_evt = (XIRawEvent*)cookie->data;
            // 获取点击位置对应的窗口
            Window root, child;
            int rx, ry, wx, wy;
            unsigned int mask;
            XQueryPointer(display, rootWindow, &root, &child, &rx, &ry, &wx, &wy, &mask);
            // 为目标窗口设置焦点
            if (child != None && frames.count(child)) {
                XSetInputFocus(display, child, RevertToPointerRoot, CurrentTime);
            }
            XFreeEventData(display, cookie);
        }
        continue;
    }
    // 原有事件处理逻辑...
}

2. 补充鼠标进入事件作为 fallback #

修改根窗口的事件掩码，添加EnterWindowMask：

long events = SubstructureRedirectMask
            | SubstructureNotifyMask
            | StructureNotifyMask
            | ButtonPressMask
            | EnterWindowMask;
XSelectInput(display, rootWindow, events);

添加鼠标进入事件处理函数：

void handleEnterNotify(const XCrossingEvent event) {
    // 可选：根据你的焦点策略，鼠标进入时自动切换焦点
    if (event.window != None && frames.count(event.window)) {
        XSetInputFocus(display, event.window, RevertToPointerRoot, CurrentTime);
    }
}

在事件循环中加入：

case EnterNotify:
    handleEnterNotify(evt.xcrossing);
    break;

3. 修正原有代码的错误 #

你的代码中handleMapRequest函数参数错误，应该改为：

void handleMapRequest(const XMapRequestEvent event)
{
  addWindowFrame(event.window, false);
  XMapWindow(display, event.window);
}

同时Expose事件错误调用了handleButtonPress，建议删掉该分支或替换为对应的处理函数。

总结 #

核心是通过X Input 2获取原始设备输入，绕过Xterm这类客户端的事件抓取，同时结合鼠标进入事件作为 fallback 策略。Mutter就是依靠XI2的原始事件拦截+合成层输入管理，确保窗口管理器始终拥有焦点控制的最高优先级。

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