Qt调用winId后WA_TransparentForMouseEvents失效及后续问题

问题背景 #

在Windows平台使用Qt 5.15.2开发水印覆盖控件时：

• 初始设置WA_TransparentForMouseEvents实现点击穿透正常，但调用被遮挡控件的winId()后穿透失效。
• 添加窗口标志Qt::FramelessWindowHint | Qt::WindowStaysOnTopHint | Qt::WindowTransparentForInput | Qt::WindowDoesNotAcceptFocus后穿透恢复，但出现两个新问题：
  1. 鼠标移至设置Qt::PointingHandCursor的QPushButton时，光标未切换为手型。
  2. 下方QQuickWidget显示黑屏，但仍可交互。
  3. 水印控件的mousePressEvent能正常触发，说明鼠标事件仍被控件捕获。

针对性解决方案 #

1. 修复光标不切换问题 #

问题根源：Qt::WindowTransparentForInput会让Windows系统直接跳过当前窗口的光标事件处理，导致下层控件的光标状态无法传递到系统层面。

修改方案：移除Qt::WindowTransparentForInput标志，仅保留WA_TransparentForMouseEvents，同时针对Windows原生窗口属性做补充设置（调用winId()会生成原生HWND，此时Qt跨平台属性可能失效）：

#include <windows.h> // 需包含Windows SDK头文件

WatermarkOverlay::WatermarkOverlay(QWidget *parent) : QWidget(parent) {
    // 调整窗口标志，移除WindowTransparentForInput
    this->setWindowFlags(Qt::FramelessWindowHint | Qt::WindowStaysOnTopHint | Qt::WindowDoesNotAcceptFocus);
    this->setAttribute(Qt::WA_ShowWithoutActivating);
    this->setAttribute(Qt::WA_TransparentForMouseEvents);
    this->setAttribute(Qt::WA_TranslucentBackground);

    parent->installEventFilter(this);

    // Windows原生窗口穿透设置（调用winId()后生效）
#ifdef Q_OS_WIN
    if (this->winId()) {
        HWND hwnd = reinterpret_cast<HWND>(this->winId());
        LONG exStyle = GetWindowLong(hwnd, GWL_EXSTYLE);
        // 添加WS_EX_TRANSPARENT，让系统忽略当前窗口的鼠标事件
        SetWindowLong(hwnd, GWL_EXSTYLE, exStyle | WS_EX_TRANSPARENT);
    }
#endif
}

2. 修复QQuickWidget黑屏问题 #

问题根源：Qt::WindowStaysOnTopHint会让水印窗口的渲染层级高于QQuickWidget的OpenGL渲染表面，导致画面被遮挡黑屏。

修改方案：

• 移除Qt::WindowStaysOnTopHint标志，改为在父控件的Resize/Show事件中主动调用raise()维持水印顶层显示。
• 为QQuickWidget设置透明渲染属性，避免层级冲突：

水印控件构造函数调整窗口标志：

this->setWindowFlags(Qt::FramelessWindowHint | Qt::WindowDoesNotAcceptFocus);

QQuickWidget初始化时添加：

QQuickWidget* quickWidget = new QQuickWidget(this);
quickWidget->setClearColor(Qt::transparent); // 启用透明背景渲染
quickWidget->setAttribute(Qt::WA_AlwaysStackOnTop, false); // 取消强制置顶

3. 确保鼠标事件正常穿透 #

如果不需要捕获水印控件的鼠标事件，直接移除mousePressEvent的重写；如果需要保留调试输出，需在函数末尾调用父类实现，确保事件继续向下传递：

void WatermarkOverlay::mousePressEvent(QMouseEvent *event) {
    qDebug() << __FUNCTION__;
    QWidget::mousePressEvent(event); // 让事件继续传递到下层控件
}

内容的提问来源于stack exchange，提问作者恰恰香Dora