PyQt5中PyQtWebEngineView全屏闪屏问题的解决方法咨询

我之前也碰到过这个烦人的全屏闪屏问题，正好研究过对应的解决方案。你找到的C++代码思路完全正确，其实在PyQt5里完全可以实现相同的功能，只是需要用到Qt的Windows平台扩展模块。

具体步骤： #

1. 确保安装必要模块
   首先要保证你的PyQt5安装包含QtWinExtras模块：如果装的是pyqt5-full包，这个模块已经自带；如果是普通PyQt5，可能需要单独安装：

   pip install pyqt5-qtwinextras
   

2. 在代码中调用对应方法
   核心就是调用QWindowsWindowFunctions::setHasBorderInFullScreen的Python版本，记得只在Windows平台执行，避免跨平台报错。下面是完整示例代码：

   import sys
   from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
   from PyQt5.QtWebEngineWidgets import QWebEngineView
   from PyQt5.QtWinExtras import QWindowsWindowFunctions
   
   class FullScreenWebView(QMainWindow):
       def __init__(self):
           super().__init__()
           self.web_view = QWebEngineView()
           self.web_view.load("https://www.example.com")
           self.setCentralWidget(self.web_view)
   
           # 添加切换全屏按钮
           self.fullscreen_btn = QPushButton("切换全屏", self)
           self.fullscreen_btn.clicked.connect(self.toggle_fullscreen)
           self.fullscreen_btn.move(20, 20)
   
           # Windows平台专属设置：解决全屏闪屏
           if sys.platform == 'win32':
               window_handle = self.windowHandle()
               if window_handle:
                   QWindowsWindowFunctions.setHasBorderInFullScreen(window_handle, True)
   
       def toggle_fullscreen(self):
           if self.isFullScreen():
               self.showNormal()
           else:
               self.showFullScreen()
   
   if __name__ == "__main__":
       app = QApplication(sys.argv)
       window = FullScreenWebView()
       window.show()
       sys.exit(app.exec_())
   

原理说明： #

Windows系统下，窗口切换全屏时，系统会重新计算窗口边框与布局，这个过程容易导致WebEngineView闪屏。通过setHasBorderInFullScreen设置为True，是让窗口在全屏模式下依然保留底层边框属性（视觉上还是全屏，看不到边框），这样系统就不会做不必要的重绘操作，从而避免闪屏。

备选方案（若QtWinExtras不可用）： #

如果因某些原因无法使用QtWinExtras，可以通过ctypes直接调用Windows API修改窗口样式，不过这个方法相对繁琐：

import ctypes
import sys
from PyQt5.QtWidgets import QMainWindow

class FullScreenWebView(QMainWindow):
    def showFullScreen(self):
        super().showFullScreen()
        if sys.platform == 'win32':
            hwnd = int(self.winId())
            # 获取当前窗口样式
            style = ctypes.windll.user32.GetWindowLongW(hwnd, -16)  # GWL_STYLE
            # 添加WS_BORDER样式
            new_style = style | 0x00800000  # WS_BORDER
            ctypes.windll.user32.SetWindowLongW(hwnd, -16, new_style)

不过更推荐第一种Qt官方提供的方法，兼容性更好。

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