PyQt5 自定义多边形Shape按钮背景无法设置透明问题求助

核心问题原因 #

• 透明样式表不生效是因为QWidget默认没有开启半透明背景属性，原生绘制会自带空白背景，仅通过background:rgba(0,0,0,0)无法实现透明效果
• 控件重叠是因为每个Shape都是独立的矩形QWidget，就算背景透明，控件的矩形区域仍会遮挡相邻控件，布局自动排列的规则也不符合多边形拼接的需求

修复方案（附可运行代码） #

采用开启透明属性+设置形状掩码的方案，保留原有自定义控件设计逻辑的同时，支持按钮点击交互：

# --------------------- IMPORTS ----------------------- #
from PyQt5 import QtGui                              
from PyQt5.QtCore import Qt, QPoint
from PyQt5.QtGui import QPolygon, QRegion
from PyQt5.QtWidgets import *                          
# ----------------------------------------------------- #


class Shape(QWidget):
    def __init__(self, parent=None):
        super(Shape, self).__init__(parent)
        # 开启透明背景支持
        self.setAttribute(Qt.WA_TranslucentBackground)
        # 固定控件大小匹配多边形尺寸
        self.setFixedSize(200, 200)
        # 定义多边形形状
        self.polygon = QPolygon([
            QPoint(0, 200),     # 左下角
            QPoint(100, 200),   # 下中点
            QPoint(200, 0),     # 右上角
            QPoint(100,0)       # 上中点
        ])
        # 设置控件掩码，仅保留多边形区域可交互、不遮挡下层
        self.setMask(QRegion(self.polygon))
        # 按钮状态标记，可用于实现悬停、按下的样式变化
        self.is_hover = False
        self.is_press = False

    def paintEvent(self, event):
        painter = QtGui.QPainter(self)
        painter.setRenderHint(QtGui.QPainter.Antialiasing)
        # 根据按钮状态修改填充色，这里示例用浅灰为常态、深灰为按下状态
        fill_color = Qt.darkGray if self.is_press else Qt.lightGray
        painter.setBrush(QtGui.QBrush(fill_color))
        painter.setPen(QtGui.QPen(Qt.black, 1, Qt.SolidLine))
        painter.drawPolygon(self.polygon)
    
    # 实现按钮点击逻辑
    def mousePressEvent(self, event):
        if self.polygon.containsPoint(event.pos(), Qt.OddEvenFill):
            self.is_press = True
            self.update()
    
    def mouseReleaseEvent(self, event):
        if self.is_press:
            self.is_press = False
            self.update()
            print("多边形按钮被点击")

class MainWindow(QWidget):
    def __init__(self, parent=None):
        super(MainWindow, self).__init__(parent)
        self.setMinimumSize(500, 500)
        # 手动排列三个多边形控件实现拼接，不要用布局自动排列
        for x in range(3):
            poly = Shape(self)
            # 每个控件偏移100px，刚好让多边形拼接对齐
            poly.move(100 * x, 150)

if __name__ == '__main__':
    import sys
    app = QApplication(sys.argv)
    mw = MainWindow()
    mw.show()
    app.exec()

你提供的问题效果参考：

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