PySide2弹窗优化：如何加深弹窗外部区域的暗化效果？

我用PyQt实现了一个自定义上下文菜单弹窗，代码如下：

class FileActionDialog(QDialog):

    def __init__(self, parent):
        super().__init__(parent)
        self.ui = Ui_ActionDialog()
        self.ui.setupUi(self)
        self.setWindowFlags(Qt.FramelessWindowHint | Qt.Popup)
        self.setAttribute(Qt.WA_TranslucentBackground)

当前弹窗外部的暗化效果不够明显，需要实现更深的暗化，也可以参考外部模糊效果的实现方式，以下是几种可行方案：

方案一：添加全屏深色遮罩层 #

在弹窗显示时，给父窗口叠加一个全屏的半透明深色遮罩，弹窗关闭时隐藏遮罩，通过调整遮罩的透明度来控制暗化程度。

修改后的代码：

class FileActionDialog(QDialog):
    def __init__(self, parent):
        super().__init__(parent)
        self.ui = Ui_ActionDialog()
        self.ui.setupUi(self)
        self.setWindowFlags(Qt.FramelessWindowHint | Qt.Popup)
        self.setAttribute(Qt.WA_TranslucentBackground)
        
        # 创建全屏遮罩层，rgba最后一位是透明度（0-255，值越大暗化越强）
        self.mask = QWidget(parent)
        self.mask.setStyleSheet("background-color: rgba(0, 0, 0, 180);")
        self.mask.hide()

    def showEvent(self, event):
        super().showEvent(event)
        # 遮罩层铺满父窗口
        self.mask.setGeometry(self.parent().geometry())
        self.mask.raise_()
        self.mask.show()
        self.raise_()  # 确保弹窗在遮罩上方

    def hideEvent(self, event):
        super().hideEvent(event)
        self.mask.hide()

可以根据需求调整rgba(0,0,0,180)中的最后一个数值，比如调到200会得到更暗的效果。

方案二：父窗口模糊+暗化组合效果 #

如果需要同时实现背景模糊+暗化的效果，可以给父窗口添加组合图形效果，弹窗显示时启用，关闭时恢复原效果。

代码示例：

from PyQt5.QtWidgets import QGraphicsBlurEffect, QGraphicsOpacityEffect

class FileActionDialog(QDialog):
    def __init__(self, parent):
        super().__init__(parent)
        self.ui = Ui_ActionDialog()
        self.ui.setupUi(self)
        self.setWindowFlags(Qt.FramelessWindowHint | Qt.Popup)
        self.setAttribute(Qt.WA_TranslucentBackground)
        
        # 创建模糊效果
        self.blur_effect = QGraphicsBlurEffect()
        self.blur_effect.setBlurRadius(8)  # 模糊半径，值越大越模糊
        
        # 创建暗化效果
        self.opacity_effect = QGraphicsOpacityEffect()
        self.opacity_effect.setOpacity(0.6)  # 透明度，值越小暗化越强
        
        # 备份父窗口原有效果
        self.parent_original_effect = self.parent().graphicsEffect()

    def showEvent(self, event):
        super().showEvent(event)
        # 先给父窗口加模糊，再加暗化
        self.parent().setGraphicsEffect(self.blur_effect)
        self.parent().setGraphicsEffect(self.opacity_effect)
        self.raise_()

    def hideEvent(self, event):
        super().hideEvent(event)
        # 恢复父窗口原有效果
        self.parent().setGraphicsEffect(self.parent_original_effect)

如果只需要纯暗化，去掉模糊效果相关代码即可。

方案三：自定义弹窗全屏背景绘制 #

让弹窗本身铺满整个屏幕，在paintEvent中绘制全屏深色背景，内部菜单居中显示，直接通过背景的透明度控制暗化程度。

代码示例：

from PyQt5.QtGui import QPainter, QColor
from PyQt5.QtWidgets import QApplication

class FileActionDialog(QDialog):
    def __init__(self, parent):
        super().__init__(parent)
        self.ui = Ui_ActionDialog()
        self.ui.setupUi(self)
        self.setWindowFlags(Qt.FramelessWindowHint | Qt.Popup | Qt.WindowStaysOnTopHint)
        self.setAttribute(Qt.WA_TranslucentBackground)
        
        # 设置弹窗为屏幕大小
        screen_geo = QApplication.desktop().availableGeometry()
        self.setGeometry(screen_geo)
        
        # 将内部菜单UI居中（假设你的UI有一个名为main_widget的主容器）
        menu_x = (screen_geo.width() - self.ui.main_widget.width()) // 2
        menu_y = (screen_geo.height() - self.ui.main_widget.height()) // 2
        self.ui.main_widget.move(menu_x, menu_y)

    def paintEvent(self, event):
        painter = QPainter(self)
        # 绘制全屏深色背景，最后一位是透明度（0-255）
        painter.fillRect(self.rect(), QColor(0, 0, 0, 200))
        super().paintEvent(event)

这种方式不需要依赖父窗口，暗化效果完全由弹窗自身控制，调整QColor的最后一个参数即可加深暗度。

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