KDE Plasma 6.0.2+Wayland下QWidget(Qt::Popup)原生阴影缺失问题求助

问题根源 #

QMenu能获取KWin原生阴影，不是因为它继承自QWidget或用了Qt::Popup标志，而是Qt内部给QMenu设置了特定的窗口角色（window role）。KWin在Wayland环境下会识别这个角色，自动为这类"菜单类弹窗"添加原生阴影。而你自定义的QWidget只是单纯设了Qt::Popup，没有告诉KWin它属于需要加阴影的窗口类型，所以没有阴影。

解决方案 #

给自定义Popup窗口设置对应的窗口角色，让KWin识别并自动添加阴影，步骤如下：

1. 在自定义Widget的构造函数中，除了设置Qt::Popup标志，建议加上Qt::FramelessWindowHint（和QMenu的窗口标志对齐，避免边框干扰）；
2. 调用window()->setWindowRole("popupmenu")，把窗口角色设为QMenu使用的"popupmenu"；
3. 可选：设置Qt::WA_TranslucentBackground属性，确保窗口背景透明（Frameless窗口通常需要这个）。

代码示例 #

#include <QWidget>

class CustomPopup : public QWidget
{
    Q_OBJECT
public:
    explicit CustomPopup(QWidget *parent = nullptr)
        : QWidget(parent, Qt::Popup | Qt::FramelessWindowHint)
    {
        // 设置窗口角色，让KWin识别为菜单弹窗
        window()->setWindowRole("popupmenu");
        // 开启透明背景（Frameless窗口必备）
        setAttribute(Qt::WA_TranslucentBackground);
        // 自定义尺寸和内容
        setMinimumSize(200, 150);
    }
};

额外说明 #

• 不用额外手动绘制阴影，KWin会基于窗口角色自动添加原生阴影，和QMenu的效果完全一致；
• 不要添加Qt::NoDropShadowWindowHint标志，会强制关闭阴影；
• 这个方法仅针对KDE Plasma的Wayland环境有效，匹配你的使用场景。

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