QGraphicsDropShadowEffect导致QWebEngineView无响应问题求助

问题描述 #

将QWebEngineView放入已应用QGraphicsDropShadowEffect效果的部件布局中时，QWebEngineView会处于无响应状态，直到执行调整窗口大小、最小化等窗口操作后才恢复正常。业务需求要求该WebView必须处于带有阴影效果的Frame内，尝试过修改部件父对象、调整布局等方式无效，推测问题与图形渲染更新相关，但无法定位具体原因。

复现代码 #

from PySide6.QtWebEngineWidgets import QWebEngineView
from PySide6.QtWidgets import QMainWindow, QWidget, QVBoxLayout, QApplication, QFrame, QGraphicsDropShadowEffect


class WebEdit(QWebEngineView):
    html = """
    <!DOCTYPE html>
        <html lang="en">
        <style>
            div {
                font-family: "Tahoma", monospace;
                white-space: nowrap;
            }
        </style>
        <body>
            <div contenteditable="true" id="myEditor" style="padding: 10px;"></div>
        </body>
    </html>
    """

    def __init__(self, parent=None):
        super().__init__(parent)
        self.setMaximumHeight(55)
        self.setHtml(self.html)


class ApplicationWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Boilerplate")
        self.resize(800, 600)

        self.central_widget = QWidget(self)
        self.central_widget.setLayout(QVBoxLayout())
        self.setCentralWidget(self.central_widget)

        self.frame = QFrame(self)
        self.frame.setLayout(QVBoxLayout())
        self.frame.setStyleSheet(f"background: yellow;")

        shadowEffect = QGraphicsDropShadowEffect(self.frame)
        shadowEffect.setBlurRadius(10)
        shadowEffect.setXOffset(0)
        shadowEffect.setYOffset(0)

        self.frame.setGraphicsEffect(shadowEffect)

        self.edit_in_frame = WebEdit(self)  # 初始无响应，窗口操作后恢复
        self.edit = WebEdit(self)  # 始终正常响应

        self.central_widget.layout().addWidget(self.frame)
        self.frame.layout().addWidget(self.edit_in_frame)
        self.central_widget.layout().addWidget(self.edit)

        self.resize(400, 400)


if __name__ == "__main__":
    app = QApplication([])
    view = ApplicationWindow()
    view.show()
    app.exec()

解决方案 #

这个问题的核心原因是QGraphicsDropShadowEffect会启用部件的离屏渲染机制，而QWebEngineView的初始渲染没有触发离屏缓冲区的更新，导致界面无响应。以下是几种可行的解决方式：

方法1：手动触发部件更新 #

在将WebView添加到Frame布局后，手动调用更新方法强制触发渲染：

# 在添加edit_in_frame到frame布局后添加以下代码
self.frame.layout().addWidget(self.edit_in_frame)
self.edit_in_frame.update()
self.frame.update()
# 或者强制处理待处理事件
QApplication.processEvents()

方法2：延迟初始化Frame内的WebView #

使用QTimer延迟创建WebView，确保阴影效果已完全应用后再初始化WebView：

from PySide6.QtCore import QTimer

# 修改ApplicationWindow的__init__方法，替换原有的edit_in_frame初始化代码
def __init__(self):
    super().__init__()
    # ... 保留其他初始化代码 ...

    self.frame.setGraphicsEffect(shadowEffect)
    self.edit = WebEdit(self)
    self.central_widget.layout().addWidget(self.frame)
    self.central_widget.layout().addWidget(self.edit)
    
    # 延迟初始化Frame内的WebView
    QTimer.singleShot(100, self.init_webview_in_frame)

    self.resize(400, 400)

def init_webview_in_frame(self):
    self.edit_in_frame = WebEdit(self)
    self.frame.layout().addWidget(self.edit_in_frame)

方法3：调整阴影效果的应用顺序 #

先将WebView添加到Frame，再为Frame设置阴影效果，避免渲染顺序冲突：

# 修改ApplicationWindow的__init__中的代码顺序
self.frame = QFrame(self)
self.frame.setLayout(QVBoxLayout())
self.frame.setStyleSheet(f"background: yellow;")

# 先添加WebView到Frame
self.edit_in_frame = WebEdit(self)
self.frame.layout().addWidget(self.edit_in_frame)

# 再设置阴影效果
shadowEffect = QGraphicsDropShadowEffect(self.frame)
shadowEffect.setBlurRadius(10)
shadowEffect.setXOffset(0)
shadowEffect.setYOffset(0)
self.frame.setGraphicsEffect(shadowEffect)

方法4：禁用WebEngine的硬件加速（备选） #

如果以上方法无效，可以强制QWebEngineView使用软件渲染，避免与硬件加速的阴影效果冲突：

# 在QApplication初始化前添加以下配置
from PySide6.QtWebEngineCore import QWebEngineSettings

QWebEngineSettings.globalSettings().setAttribute(QWebEngineSettings.WebAttribute.Accelerated2dCanvasEnabled, False)
QWebEngineSettings.globalSettings().setAttribute(QWebEngineSettings.WebAttribute.WebGLEnabled, False)

if __name__ == "__main__":
    app = QApplication([])
    # ... 后续代码 ...

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