Qt实现QWebEngineView整页打印并显示QPrintPreviewDialog

这个坑我之前踩过！你遇到的核心问题是：直接使用当前显示的QWebEngineView的page().print()时，页面会按照当前视图窗口的可见区域来渲染打印内容，而不是整个文档的完整内容。下面给你两种靠谱的解决方案：

方案一：使用独立的QWebEnginePage进行无约束打印预览 #

这是最稳妥的方法，我们创建一个不绑定到任何视图的独立QWebEnginePage，它不会受当前窗口大小的限制，会完整渲染整个文档。

代码示例 #

from PyQt5.QtWebEngineWidgets import QWebEnginePage, QWebEngineView
from PyQt5.QtPrintSupport import QPrintPreviewDialog

class YourWidget(QWebEngineView):
    def __init__(self):
        super().__init__()
        # 初始化你的视图，比如加载目标URL
        self.load("https://example.com")

    def show_full_page_print_preview(self):
        # 创建独立的打印专用页面
        print_page = QWebEnginePage(self)
        # 同步当前视图的内容（如果是本地HTML可以用setHtml替代setUrl）
        print_page.setUrl(self.url())

        # 等待页面加载完成再触发预览，避免打印空白内容
        def on_page_loaded(ok):
            if not ok:
                print("页面加载失败，无法生成预览")
                return
            # 初始化打印预览对话框
            preview_dialog = QPrintPreviewDialog()
            # 绑定打印请求的处理函数
            def handle_print_request(printer):
                # 调用独立页面的print方法，确保整页渲染
                print_page.print(printer, lambda success: print(f"打印{'成功' if success else '失败'}"))
            preview_dialog.paintRequested.connect(handle_print_request)
            # 显示预览对话框
            preview_dialog.exec_()

        print_page.loadFinished.connect(on_page_loaded)

方案二：临时调整当前页面的视口大小（快捷但有局限） #

如果你不想创建新页面，可以临时把当前页面的视口大小设置为文档的完整尺寸，打印完成后再恢复。不过这个方法可能会导致当前视图短暂变形，适合简单场景：

代码示例 #

def show_full_page_preview_quick(self):
    # 获取文档的完整尺寸
    doc_size = self.page().contentsSize()
    # 保存当前视口大小，方便后续恢复
    original_viewport = self.page().viewportSize()
    # 设置视口为文档完整大小
    self.page().setViewportSize(doc_size)

    # 创建预览对话框
    preview_dialog = QPrintPreviewDialog()
    def handle_print(printer):
        self.page().print(printer, lambda success: None)
        # 打印完成后立即恢复原视口大小，避免影响视图显示
        self.page().setViewportSize(original_viewport)
    preview_dialog.paintRequested.connect(handle_print)
    preview_dialog.show()

为什么你的原始代码不行？ #

你直接将paintRequested信号连接到self.loader.page().print，而当前QWebEngineView的page()是和视图窗口绑定的，它的布局会自动适配窗口大小，导致打印时只渲染可见区域的内容。而独立的QWebEnginePage没有视图约束，会按照文档的完整结构或打印机的页面设置来渲染所有内容。

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