Ubuntu 23.04下QML实现独立置顶子窗口问题求助

问题核心 #

Linux窗口管理器（如GNOME Mutter）的窗口层级规则与Windows差异显著，Qt.X11BypassWindowManagerHint会绕过窗口管理器的标准逻辑，反而导致全局置顶失效；该标志仅适用于X11环境，Ubuntu 23.04默认的Wayland会话完全不支持。

有效实现方案 #

1. 改用标准置顶属性 #

放弃Qt.X11BypassWindowManagerHint，使用Qt.WindowStaysOnTopHint，同时确保子窗口脱离父窗口层级关联（你已实现独立状态，此步只需确认）。

示例QML代码：

Window {
    id: floatingWindow
    visible: true
    width: 300
    height: 200
    title: "全局置顶窗口"
    // 核心置顶标志，搭配基础窗口属性
    flags: Qt.Window | Qt.WindowStaysOnTopHint | Qt.WindowDoesNotAcceptFocus
    // 彻底脱离父窗口层级，确保独立存在
    parent: null
    // 父窗口关闭时不跟随关闭（按需调整逻辑）
    Component.onDestruction: {
        if (!floatingWindow.closing) {
            floatingWindow.show()
        }
    }
}

2. Wayland环境适配 #

Ubuntu 23.04默认使用Wayland会话，需注意：

• 使用Qt 5.15+或Qt 6+版本，这类版本对Wayland的窗口属性支持更完善。
• 若无需窗口装饰，启动应用时设置环境变量：QT_WAYLAND_DISABLE_WINDOWDECORATION=1，避免窗口管理器的额外限制。

3. X11环境强制层级调整 #

若使用X11会话（登录时选择Ubuntu on Xorg），可通过X11标准属性强制设置置顶：
在C++辅助代码中添加：

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

void setWindowAlwaysOnTop(QWindow *window) {
    Display *display = QX11Info::display();
    Window winId = window->winId();
    Atom netWmState = XInternAtom(display, "_NET_WM_STATE", False);
    Atom netWmStateAbove = XInternAtom(display, "_NET_WM_STATE_ABOVE", False);
    
    XChangeProperty(display, winId, netWmState, XA_ATOM, 32, PropModeReplace,
                    reinterpret_cast<unsigned char*>(&netWmStateAbove), 1);
    XFlush(display);
}

在QML中调用（需注册C++类到QML上下文）：

Component.onCompleted: {
    cppUtils.setWindowAlwaysOnTop(floatingWindow)
}

验证注意事项 #

• 避免使用Qt.Tool、Qt.Sheet这类会限制层级的窗口标志。
• Wayland下关闭系统自带的置顶快捷键（如GNOME的Alt+Space），避免冲突。
• 测试时确保子窗口未被标记为模态窗口。

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