如何将Qt应用的QWidget窗口放置到非默认X DISPLAY？

要在同一个Qt应用里，把新的QWidget窗口放到指定的X DISPLAY（比如:1），同时让主窗口保持在默认DISPLAY运行，你可以借助Qt的QScreen类轻松实现，不用修改全局环境变量或者启动多个应用实例。下面是具体的步骤和代码示例：

核心思路 #

Qt的每个QScreen实例对应X11环境里的一个显示输出（关联特定DISPLAY）。你只需要找到目标DISPLAY对应的QScreen，再把新创建的QWidget绑定到这个屏幕上就行。

具体实现步骤 #

1. 确保目标DISPLAY可访问 #

先确认目标X DISPLAY处于运行状态，且你的应用有权限访问它：

• 检查X服务是否在运行：执行ps aux | grep Xorg，确认能看到:1相关的进程
• 临时开放权限（测试用）：运行xhost +:1，或者用xauth配置持久化权限（更安全）

2. 在代码中定位目标DISPLAY的QScreen #

遍历应用的所有可用屏幕，匹配目标DISPLAY的名称：

#include <QApplication>
#include <QScreen>
#include <QWidget>
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    // 主窗口运行在默认DISPLAY，这里创建示例主窗口
    QWidget mainWindow;
    mainWindow.setWindowTitle("Main Window on Default Display");
    mainWindow.resize(400, 300);
    mainWindow.show();

    // 目标DISPLAY，这里设置为":1"
    const QString targetDisplay = ":1";
    QScreen* targetScreen = nullptr;

    // 遍历所有屏幕，找到匹配目标DISPLAY的实例
    for (QScreen* screen : a.screens()) {
        // X11环境下QScreen的名称格式通常是 "X11::<display>.<screen>"，比如"X11:::1.0"
        if (screen->name().contains(targetDisplay)) {
            targetScreen = screen;
            break;
        }
    }

    if (!targetScreen) {
        qWarning() << "无法找到目标DISPLAY:" << targetDisplay;
        return a.exec();
    }

    // 3. 创建新窗口并绑定到目标屏幕
    QWidget* remoteWindow = new QWidget();
    remoteWindow->setWindowTitle("Window on :1");
    remoteWindow->resize(400, 300);
    // 将窗口设置到目标屏幕
    remoteWindow->setScreen(targetScreen);
    // 显示窗口
    remoteWindow->show();

    return a.exec();
}

关键细节说明 #

• QScreen匹配逻辑：X11中DISPLAY的格式是hostname:display_number.screen_number（比如:1.0），screen->name()会包含目标DISPLAY字符串，用contains()就能匹配到对应的屏幕。
• 权限问题：如果找不到目标QScreen，大概率是应用没有访问目标DISPLAY的权限，检查xauth配置或者临时开放权限即可。
• 跨平台兼容性：这种方法基于Qt的抽象层，虽然你是针对X11环境，但代码也能在其他支持多屏幕的平台上运行。

备选方案（底层X11 API） #

如果Qt的抽象层无法满足特殊需求，你可以直接用X11原生API打开目标DISPLAY并创建窗口，但这种方法会失去跨平台性：

#include <X11/Xlib.h>

// 打开目标DISPLAY
Display* xDisplay = XOpenDisplay(":1");
if (!xDisplay) {
    qWarning() << "无法打开目标DISPLAY :1";
    return;
}

// 创建X11窗口
Window xWindow = XCreateSimpleWindow(xDisplay, DefaultRootWindow(xDisplay),
                                     100, 100, 400, 300, 1,
                                     BlackPixel(xDisplay, DefaultScreen(xDisplay)),
                                     WhitePixel(xDisplay, DefaultScreen(xDisplay)));
XMapWindow(xDisplay, xWindow);
XFlush(xDisplay);

// 将X11窗口包装成Qt QWidget
QWidget* qtWindow = QWidget::createWindowContainer(new QWindow(), nullptr);
qtWindow->setWindowTitle("X11 Native Window on :1");
qtWindow->show();

不过一般情况下，更推荐使用Qt封装的QScreen方法，代码更简洁且兼容性更好。

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