如何让Qt窗口在KWin Wayland中始终置顶并固定位置？

由于Wayland compositor（如Plasma）对窗口层级的管理逻辑与X11不同，Qt.WindowStaysOnTopHint无法直接生效，可通过以下两种方式解决：

方法一：使用KDE KWindowSystem库（推荐，跨X11/Wayland） #

KWindowSystem是KDE框架提供的窗口管理工具，能自动适配X11和Wayland环境，无需区分平台：

1. 添加依赖：在项目的CMakeLists.txt中引入KF5 WindowSystem：

find_package(KF5WindowSystem REQUIRED)
target_link_libraries(你的应用名称 PRIVATE KF5::WindowSystem)

2. 调用置顶接口：在窗口初始化完成后，调用setKeepAbove方法：

#include <KWindowSystem>

// 假设你的窗口对象为QWidget *mainWindow或QWindow *window
KWindowSystem::setKeepAbove(mainWindow->winId(), true);

该方法会自动向Plasma compositor发送置顶请求，同时保留在X11环境下的兼容性。

方法二：直接操作Wayland XDG Shell协议（无KDE依赖） #

如果不想依赖KDE库，可通过Qt的Wayland客户端接口直接设置xdg_toplevel的always_on_top属性：

1. 添加依赖：确保项目链接QtWaylandClient库（CMake示例）：

find_package(Qt6 REQUIRED COMPONENTS WaylandClient)
target_link_libraries(你的应用名称 PRIVATE Qt6::WaylandClient)

2. 设置置顶属性：在窗口初始化后，获取Wayland窗口对象并设置：

#include <QtWaylandClient/QWaylandXdgToplevel>
#include <QtWaylandClient/QWaylandWindow>

// 检查是否运行在Wayland环境
if (qEnvironmentVariableIsSet("QT_QPA_PLATFORM") && 
    QString(qgetenv("QT_QPA_PLATFORM")).startsWith("wayland")) {
    if (auto *waylandWindow = qobject_cast<QWaylandWindow*>(window->handle())) {
        if (auto *xdgToplevel = waylandWindow->xdgToplevel()) {
            xdgToplevel->setAlwaysOnTop(true);
        }
    }
}
// 同时保留X11下的标志设置
window->setFlag(Qt::WindowStaysOnTopHint, true);

注意事项 #

• 确保窗口类型为Qt::Window（而非Qt::Widget或其他类型），避免compositor的特殊处理规则影响。
• 检查Plasma的窗口管理设置，确保没有全局规则覆盖你的窗口置顶属性（可在Plasma系统设置→窗口管理→窗口规则中查看）。

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