PyQt5中如何在Widget上方前置绘制图形？

这个问题我之前也踩过坑！默认情况下，PyQt5里QWidget的绘制逻辑是：父控件先完成自身背景和内容的绘制，然后子控件会依次在父控件的上方进行绘制。所以你直接在父控件的paintEvent()里画的图形，自然会被上层的子控件（比如按钮）盖住，显示在底层。

下面给你两种实用的解决方案，最推荐第一种，简单又不影响原有控件的功能：

方案一：添加透明覆盖层（Overlay）绘制 #

这种方法是创建一个独立的透明Widget作为覆盖层，放在所有子控件的顶层，专门用来绘制你需要的图形。好处是不修改原有控件的绘制逻辑，还能保证图形始终在最上层，同时底层控件的交互（比如按钮点击）不受影响。

完整代码示例 #

from PyQt5.QtGui import QPainter, QPen, QBrush, QColor
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget, QHBoxLayout, QPushButton
import sys

# 自定义覆盖层控件，负责绘制顶层图形
class OverlayWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 设置透明背景，避免覆盖底层控件的显示
        self.setAttribute(Qt.WA_TranslucentBackground)
        # 设置鼠标穿透，让底层控件能正常接收点击、hover等事件
        self.setAttribute(Qt.WA_TransparentForMouseEvents)
    
    def paintEvent(self, event):
        # 在这里编写你的绘制逻辑
        painter = QPainter(self)
        # 示例：绘制一个半透明红色矩形
        pen = QPen(QColor(255, 0, 0), 3)  # 红色边框，宽度3
        brush = QBrush(QColor(255, 0, 0, 50))  # 半透明红色填充（透明度50）
        painter.setPen(pen)
        painter.setBrush(brush)
        painter.drawRect(50, 50, 200, 100)
    
    def resizeEvent(self, event):
        # 跟随父控件自动调整大小，始终铺满父控件
        self.setGeometry(self.parent().rect())

# 你的原有容器控件
class MyWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.initUI()
    
    def initUI(self):
        # 原有布局和子控件
        layout = QHBoxLayout(self)
        btn1 = QPushButton("按钮1")
        btn2 = QPushButton("按钮2")
        layout.addWidget(btn1)
        layout.addWidget(btn2)
        
        # 添加覆盖层到当前控件
        self.overlay = OverlayWidget(self)
        self.overlay.show()
    
    def resizeEvent(self, event):
        # 父控件大小变化时，同步调整覆盖层大小
        self.overlay.setGeometry(self.rect())

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = QMainWindow()
    widget = MyWidget()
    window.setCentralWidget(widget)
    window.resize(400, 200)
    window.show()
    sys.exit(app.exec_())

关键说明 #

• Qt.WA_TranslucentBackground：让覆盖层背景透明，不会遮挡底层控件的内容
• Qt.WA_TransparentForMouseEvents：让鼠标事件直接穿透覆盖层，底层按钮可以正常点击
• 覆盖层通过setGeometry()始终铺满父控件，保证图形能正确显示在整个区域

方案二：调整绘制顺序（仅适用于非容器控件） #

如果你的控件不是容器（没有子控件），或者子控件是通过代码手动绘制而非布局管理的，可以尝试调整paintEvent()中的绘制顺序：先调用父类的paintEvent()完成原有内容绘制，再执行自己的绘制逻辑。示例代码如下：

class MyWidget(QWidget):
    def paintEvent(self, event):
        # 先让父类完成原有绘制（包括背景、子控件）
        super().paintEvent(event)
        # 再绘制自己的图形，此时图形会在原有内容上方
        painter = QPainter(self)
        pen = QPen(QColor(255, 0, 0), 3)
        painter.setPen(pen)
        painter.drawLine(0, 0, self.width(), self.height())

不过注意：如果你的控件是使用布局管理子控件的，这种方法可能无效——因为布局中的子控件是在父控件paintEvent()执行完成后才进行绘制的，所以你在父控件paintEvent()最后画的图形还是会被子控件盖住。

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