QtQuick透明窗口未完全透明，角落显白色背景求解决

我有一个本该设置为透明的QtQuick窗口，窗口上方还叠加有弹窗，但在窗口角落处可见白色背景。尝试修改窗口标志、颜色等设置均无效果，请问有人知晓问题原因及解决方法吗？感谢您的解答。

import QtQuick 2.15
import QtQuick.Controls 2.15
import QtQuick.Layouts 1.3
import QtQuick.Window 2.3
import QtQuick.Controls.Styles 1.4

Window {
    id: alertsWindow
    width: 750 * scale; height: 500 * scale
    x: Screen.width / 2 - width / 2
    y: Screen.height / 2 - height / 2
    visible: false
    modality: Qt.ApplicationModal
    //    flags: Qt.FramelessWindowHint
    property int alertsData;
    property int eStopData;
    flags: Qt.Window | Qt.FramelessWindowHint | Qt.WA_TranslucentBackground | Qt.WA_NoSystemBackground
    color: "transparent"
}

问题原因 #

你混用了QWidget框架的窗口属性（WA_TranslucentBackground、WA_NoSystemBackground）和QtQuick Window的设置，这些WA开头的属性是QWidget专属的，QtQuick Window并不直接支持，反而会引发渲染冲突，导致角落出现白色残留。另外部分平台（比如Windows）对QtQuick窗口的透明渲染有特殊要求。

解决方法 #

• 修正窗口标志：移除QWidget相关属性，只保留QtQuick Window支持的标志：

  flags: Qt.Window | Qt.FramelessWindowHint
  

• 启用透明背景支持：添加allowTransparentBackground: true属性（QtQuick 2.3及以上版本支持），确保窗口允许透明背景渲染：

  allowTransparentBackground: true
  

• 检查子控件背景：确认窗口内所有子Item、控件都没有默认白色背景，比如Rectangle或Item的color需设为透明或与窗口背景一致。
• Windows平台额外设置：如果在Windows上运行，若用QQuickView加载QML，需在C++代码中补充：

  QQuickView view;
  view.setColor(Qt::transparent);
  view.setAttribute(Qt::WA_TranslucentBackground);
  view.setSource(QUrl("qrc:/main.qml"));
  view.show();
  

• 验证Qt版本：建议升级到Qt 5.15.2及以上稳定版本，避免旧版本的透明渲染bug。

按以上步骤调整后，窗口角落的白色背景即可消除，实现完全透明效果。

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