Qt5嵌入X11外部窗口失败：目标窗口仍独立显示求助

我之前在X11环境下处理Qt嵌入外部窗口时也碰到过类似问题，结合你的环境和代码，给你几个排查和修复的方向：

1. 先确认目标窗口支持被嵌入（X11属性检查） #

外部窗口可能默认不允许被重新父化，你可以先用xprop工具查看目标窗口的属性：

• 检查是否存在WM_TRANSIENT_FOR属性，如果没有，可能需要给目标窗口预先设置这个属性（或者在创建目标窗口时就指定它为临时窗口类型）。
• 同时确认目标窗口的_NET_WM_WINDOW_TYPE不是_NET_WM_WINDOW_TYPE_DESKTOP这类顶级窗口类型，否则Qt无法将其作为子窗口嵌入。

2. 修正QWindow的父窗口关联逻辑 #

你目前只给容器Widget设置了Parent，但没有将外部QWindow的父窗口关联到主窗口的底层QWindow上，这会导致外部窗口仍然保持顶级窗口状态。修改代码如下：

explicit main_window(const uint32_t wid) {
    QWindow* window = QWindow::fromWinId((WId)wid);
    // 将外部窗口的父设置为主窗口的底层QWindow，这是嵌入的关键
    window->setParent(this->windowHandle());
    window->setFlags(Qt::FramelessWindowHint | Qt::SubWindow); // 明确标记为子窗口
    QWidget* widget = QWidget::createWindowContainer(window);
    widget->setParent(this);
    widget->setMinimumSize(640, 480); // 给容器设置最小尺寸，避免窗口因无大小不显示
    auto* layout = new QGridLayout{};
    layout->addWidget(widget);
    setLayout(layout);
    // 强制触发窗口重绘和映射
    window->show();
    widget->show();
}

3. 手动兜底：调用X11 API重新父化窗口 #

如果上面的修改还是无效，可能需要直接调用X11的底层API强制重新父化窗口（需要链接X11库）：

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

// 在main_window构造函数中添加：
Display* dpy = QX11Info::display();
Window targetWin = (Window)wid;
Window parentWin = (Window)this->windowHandle()->winId();
XReparentWindow(dpy, targetWin, parentWin, 0, 0);
XFlush(dpy); // 立即刷新X11请求

注意：添加这段代码前，要确保项目链接了X11库（在qmake中添加LIBS += -lX11，CMake中添加target_link_libraries(your_project X11)）。

4. 修复背景泄漏问题 #

背景泄漏通常是因为外部窗口的背景没有被Qt容器正确合成，你可以尝试：

• 给主窗口设置明确的背景色：

  this->setStyleSheet("background-color: #ffffff;");
  

• 确保外部窗口的透明度属性正确：

  window->setOpacity(1.0);
  

额外排查点 #

• 确认你用xwininfo获取的是目标窗口的顶层窗口ID，而不是窗口内部子控件的ID。
• 运行程序时，确保当前用户有操作X11窗口的权限（比如没有被Xauthority限制）。

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