Qt.WA_PaintOnScreen属性作用、效果验证及父内容传播疑问

问题背景 #

我正在深入学习QWidget，参考Qt官方文档时遇到以下问题：
文档说明自Qt 4.1起，默认情况下父部件的内容会传播给所有子部件，除非设置了WA_PaintOnScreen属性。自定义部件可利用此特性实现不规则区域更新或半透明绘制。但我将父部件的Qt.WA_PaintOnScreen属性设为True后，发现父部件内容似乎仍在传播，无法理解该属性的实际作用。
此外文档提到：「设置WA_PaintOnScreen属性可强制创建原生窗口（这意味着3）」，请问：

1. WA_PaintOnScreen属性的具体作用是什么？
2. 如何查看该属性生效后的效果？
3. 父部件内容的传播范围是怎样的？

附上测试代码：

from PySide6.QtWidgets import QWidget, QLabel, QApplication
from PySide6.QtGui import QPixmap, QPainter, QFont, QColor, QPolygon, QPalette, QRegion
from PySide6.QtCore import Qt, QRect, QPoint
import sys

class ChildWidget(QWidget):

    def __init__(self, parent=None):
        super().__init__(parent)      
        self.setGeometry(0, 0, 125, 100)
       
    def paintEvent(self, event):
        painter = QPainter()
        painter.begin(self)        
        brush = painter.brush()
        brush.setColor(Qt.white)
        brush.setStyle(Qt.SolidPattern)
        painter.setBrush(brush)        
        painter.drawRect(self.rect())

        brush = painter.brush()
        brush.setColor(Qt.red)
        brush.setStyle(Qt.DiagCrossPattern)
        painter.setBrush(brush)
        painter.drawRect(self.rect())

        #propagated in spite of Qt.WA_PaintOnScreen
        print(painter.font())
        
        painter.end()
        return super().paintEvent(event)
    
class ParentWidget(QWidget):

    def __init__(self, parent=None):
        super().__init__(parent)
        self.setAttribute(Qt.WA_PaintOnScreen, True)
        self.childWidget = ChildWidget(parent=self)
        self.childWidget.move(100, 100)
        self.childWidget.repaint()
        self.setFont(QFont("Times New Roman", 18))
    
def main():
    app = QApplication()
    w = ParentWidget()
    w.show()
    sys.exit(app.exec())

if __name__ == "__main__":
    main()

问题解答 #

1. WA_PaintOnScreen属性的具体作用是什么？ #

WA_PaintOnScreen是Qt的窗口属性之一，核心作用是强制部件使用原生窗口系统的直接绘制，而非Qt的合成绘制机制：

• 默认情况下，Qt使用离屏绘制（offscreen painting）：先把内容绘制到缓冲区，再统一合成到屏幕，父子部件共享这个合成机制，父部件的绘制内容会"渗透"到子部件的绘制上下文。
• 当设置WA_PaintOnScreen为True时，部件会创建独立的原生窗口句柄（如Windows的HWND、X11的Window），直接在屏幕对应的内存区域绘制，不再参与Qt的合成流程。这意味着：
  • 该部件的绘制不会被Qt的合成器修改，也不会和其他部件的绘制上下文共享状态；
  • 未设置该属性的子部件仍属于Qt合成体系，和父部件的原生窗口是独立层级关系，父部件的绘制不会自动覆盖或渗透到子部件。

注意：你代码中观察到的字体传播，属于Qt的部件属性继承（font、palette等），和WA_PaintOnScreen控制的绘制传播不是一回事——属性继承是Qt部件树的固有行为，不受该绘制属性影响。

2. 如何查看该属性生效后的效果？ #

可以通过以下几种方式验证WA_PaintOnScreen是否生效：

• 检查窗口句柄：调用self.winId()，若返回非零值，且通过系统工具（如Windows的Spy++、Linux的xwininfo）能看到该部件拥有独立的原生窗口，说明属性生效；
• 绘制行为验证：给ParentWidget添加paintEvent，绘制一个大的蓝色矩形。默认模式下子部件区域会显示父部件的蓝色背景；设置WA_PaintOnScreen后，子部件区域会保持自身的白色+红色交叉图案，不会显示父部件的蓝色；
• 层级验证：使用系统窗口管理器查看窗口层级，设置属性后的父部件会作为独立窗口存在，子部件若未设置该属性则属于Qt合成的子元素。

3. 父部件内容的传播范围是怎样的？ #

这里的"内容传播"需要区分两种场景：

• 部件属性传播：font、palette、cursor等属性会沿着部件树从父到子自动继承，除非子部件显式重设属性。这种传播不受WA_PaintOnScreen影响，是Qt部件系统的默认行为；
• 绘制内容传播：默认合成模式下，父部件的绘制内容会作为子部件绘制的"背景"，子部件如果不填充整个区域，会显示父部件的内容。当父部件设置WA_PaintOnScreen后，这种绘制传播会被打断：
  • 父部件的绘制仅作用于自己的原生窗口；
  • 子部件属于Qt合成体系，其绘制缓冲区和父部件的原生窗口独立，父部件的绘制内容不会出现在子部件的绘制上下文中；
  • 如果子部件也设置了WA_PaintOnScreen，它会成为独立的原生窗口，层级在父窗口之上，完全和父部件的绘制隔离。

你的测试代码中打印的painter.font()属于属性继承，不是绘制内容传播，所以即使设置了WA_PaintOnScreen，依然会继承父部件的字体。

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