PyQt5无标题栏半透明窗口组件圆角不生效问题求助

问题分析 #

你遇到的问题核心原因有两点：

• 普通QWidget默认不会根据样式表的border-radius裁剪自身绘制区域，即使设置了圆角样式，组件背景仍会以矩形显示。
• 全局设置setWindowOpacity(0.9)会让整个窗口（包括子组件）的透明度被统一调整，干扰组件自身半透明背景的渲染逻辑。

解决方案 #

通过以下改动即可实现预期的圆角半透明效果：

• 将半透明组件从QWidget改为QFrame，QFrame原生支持根据样式表的border-radius自动裁剪背景区域。
• 移除窗口的setWindowOpacity(0.9)，改用组件自身的rgba背景属性控制透明度，避免全局透明度干扰。
• 给主窗口添加WA_TranslucentBackground属性，确保窗口背景真正透明。
• 确保组件启用WA_StyledBackground属性，保证样式表能正确作用于组件。

修改后的完整代码 #

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QPushButton, QFrame
from PyQt5.QtCore import Qt, QPoint
from PyQt5.QtGui import QFont

class TranslucentWidget(QFrame):  # 改为QFrame
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setGeometry(0, 0, 500, 600)
        self.setAttribute(Qt.WA_StyledBackground, True)  # 确保样式表生效
        self.setStyleSheet(
            "background-color: rgba(255, 255, 255, 150);"
            "border-radius: 20px;"
        )

class TranslucentWindow(QWidget):
    def __init__(self):
        super().__init__()
        
        self.initUI()
        self.oldPos = self.pos()
        
    def initUI(self):
        self.setFixedSize(500, 600)
        self.setWindowTitle('Translucent Window')
        self.setStyleSheet("background: transparent;")
        # 移除全局窗口透明度设置，改用组件rgba控制
        self.setAttribute(Qt.WA_TranslucentBackground)  # 开启窗口透明背景
        
        self.setWindowFlags(Qt.FramelessWindowHint)
        
        font = QFont()
        font.setFamily("Roboto")
        
        self.translucentWidget = TranslucentWidget(self)
        
        # 最小化按钮
        self.minimizeButton = QPushButton('_', self.translucentWidget)
        self.minimizeButton.setGeometry(430, 10, 30, 30)
        self.minimizeButton.setFont(font)
        self.minimizeButton.setStyleSheet(
            "background-color: white;"
            "border-radius: 15px;"
        )
        self.minimizeButton.clicked.connect(self.showMinimized)
        
        # 关闭按钮
        self.closeButton = QPushButton('X', self.translucentWidget)
        self.closeButton.setGeometry(465, 10, 30, 30)
        self.closeButton.setFont(font)
        self.closeButton.setStyleSheet(
            "background-color: white;"
            "border-radius: 15px;"
        )
        self.closeButton.clicked.connect(self.close)
        
    def mousePressEvent(self, event):
        self.oldPos = event.globalPos()
        
    def mouseMoveEvent(self, event):
        delta = QPoint(event.globalPos() - self.oldPos)
        self.move(self.x() + delta.x(), self.y() + delta.y())
        self.oldPos = event.globalPos()
        
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = TranslucentWindow()
    window.show()
    sys.exit(app.exec_())

额外说明 #

如果坚持使用QWidget而非QFrame，可以通过手动设置遮罩的方式实现圆角：
在TranslucentWidget的__init__中添加：

from PyQt5.QtGui import QPainterPath, QRegion
path = QPainterPath()
path.addRoundedRect(self.rect(), 20, 20)
self.setMask(QRegion(path.toFillPolygon().toPolygon()))

这种方式需要在组件大小变化时重新计算遮罩，而使用QFrame则无需额外处理，更简洁稳定。

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