Qt6下如何阻止QOpenGLWindow点击获取键盘焦点？兼询版本差异原因

行为变更原因 #

Qt 6对X11平台的窗口焦点管理逻辑进行了重构：

• Qt 5中，Qt::Tooltip标志会直接让X11将窗口标记为不接收焦点的类型，但Qt 6调整了窗口标志与X11原生属性的映射规则，这类标志不再强制覆盖窗口的焦点请求行为。
• QOpenGLWindow本质是独立的顶层窗口（即使嵌入到其他界面中），Qt 6默认遵循X11的窗口系统行为，即点击窗口时自动触发焦点请求，这个逻辑绕过了原有的Qt标志限制。
• 无法通过重写event(QEvent*)捕获FocusIn事件，是因为该事件在窗口系统层面被处理，没有传递到Qt的事件分发链中。

可行解决方案 #

1. 改用QOpenGLWidget替代QOpenGLWindow #

这是最跨平台的方案：将QOpenGLWindow替换为QOpenGLWidget，作为子部件嵌入到父QWidget中。QOpenGLWidget是子部件，默认不会抢占父窗口或其他部件的焦点，完全符合需求。

2. 直接设置X11原生窗口属性（Linux专属） #

通过X11原生API强制标记窗口为不可获取焦点，绕过Qt 6的标志限制：

#include <QX11Info>
#include <X11/Xlib.h>

void disableOpenGLWindowFocus(QOpenGLWindow* window) {
    Display* display = QX11Info::display();
    Window x11Window = window->winId();

    // 设置窗口类型为Utility，这类窗口默认不抢焦点
    Atom netWmType = XInternAtom(display, "_NET_WM_WINDOW_TYPE", false);
    Atom netWmTypeUtility = XInternAtom(display, "_NET_WM_WINDOW_TYPE_UTILITY", false);
    XChangeProperty(display, x11Window, netWmType, XA_ATOM, 32,
                    PropModeReplace, (unsigned char*)&netWmTypeUtility, 1);

    // 移除WM_TAKE_FOCUS协议，阻止窗口请求焦点
    Atom wmTakeFocus = XInternAtom(display, "WM_TAKE_FOCUS", false);
    XSetWMProtocols(display, x11Window, nullptr, 0);
}

需要在项目的.pro文件中添加X11库依赖：

LIBS += -lX11

3. 重写nativeEvent捕获底层焦点事件 #

通过nativeEvent直接拦截X11的FocusIn事件，阻止焦点切换：

bool MyOpenGLWindow::nativeEvent(const QByteArray& eventType, void* message, qintptr* result) {
    if (eventType == "xcb_generic_event_t") {
        auto* xcbEvent = static_cast<xcb_generic_event_t*>(message);
        // 拦截XCB_FOCUS_IN事件
        if ((xcbEvent->response_type & 0x7F) == XCB_FOCUS_IN) {
            *result = 1; // 标记事件已处理
            return true;
        }
    }
    return QOpenGLWindow::nativeEvent(eventType, message, result);
}

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