PyQt5生成PDF时添加内边距（Padding）的实现方案咨询

我用PyQt5生成PDF的功能正常，但无法给PDF内容添加上下左右内边距，希望实现内容与页面边缘存在间距的效果。相关代码如下：

from PyQt5 import QtCore, QtWidgets, QtWebEngineWidgets

def printhtmltopdf(html_in, pdf_filename):
    app = QtWidgets.QApplication([])
    page = QtWebEngineWidgets.QWebEnginePage()

    def handle_pdfPrintingFinished(*args):
        print("finished: ", args)
        app.quit()

    def handle_loadFinished(finished):
        page.printToPdf(pdf_filename)

    page.pdfPrintingFinished.connect(handle_pdfPrintingFinished)
    page.loadFinished.connect(handle_loadFinished)

    page.setZoomFactor(1)
    page.setHtml(html_in)

    app.exec()

printhtmltopdf(
    result,    # raw html variable
    "file.pdf",
)

当前生成效果：

预期效果：

解决方案 #

方法一：通过HTML/CSS控制边距

直接在传入的HTML内容中添加CSS打印规则，利用@page定义页面全局边距，这是最通用的方法，无需修改Python代码：

<!DOCTYPE html>
<html>
<head>
    <style>
        /* 定义页面打印边距，单位支持cm、mm、px */
        @page {
            margin: 2cm;
        }
        /* 重置body默认边距避免冲突 */
        body {
            margin: 0;
            padding: 0;
        }
        /* 如果需要内容内部额外间距，可添加容器设置padding */
        .content-wrap {
            padding: 0.5cm;
        }
    </style>
</head>
<body>
    <div class="content-wrap">
        <!-- 你的原有HTML内容 -->
    </div>
</body>
</html>

QtWebEngine的PDF打印基于WebKit引擎，完全支持CSS打印标准，这种方式兼容性最好。

方法二：通过PyQt5的打印布局参数设置

如果不想修改HTML，可以使用QWebEnginePage.PageLayout来设置页面边距，需要PyQt5 5.13及以上版本支持：
修改代码中的handle_loadFinished函数：

def handle_loadFinished(finished):
    # 创建页面布局对象
    page_layout = QtWebEngineWidgets.QWebEnginePage.PageLayout()
    # 设置四边边距为20毫米，可根据需求调整数值
    margins = QtCore.QMarginsF(20, 20, 20, 20)
    page_layout.setMargins(margins)
    # 设置边距单位为毫米，也可选Pixel、Centimeter等
    page_layout.setUnits(QtWebEngineWidgets.QWebEnginePage.Millimeter)
    # 使用带布局参数的printToPdf方法
    page.printToPdf(pdf_filename, page_layout)

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