Qt6.8中进行PDF文件读取和编辑

1.环境配置

在 .pro 文件中添加 PDF 模块依赖：

QT += core gui pdf  # 添加 pdf 模块

注意：独立 pdf 模块的起始版本是Qt 5.15，建议需要 PDF 功能的开发者优先选择此版本或更高版本

2.读取PDF 文件

核心类：QPdfDocument（加载、解析 PDF）

功能：获取页面数、提取文本、渲染页面为图像。

代码示例：

#include <QPdfDocument>

#include <QImage>

#include <QDebug>

void readPdfFile(const QString &filePath) {

    // 加载 PDF 文档

    QPdfDocument pdfDoc;

    if (pdfDoc.load(filePath) != QPdfDocument::Error::None) {

        qWarning() << "Failed to load PDF file";

        return;

    }

    // 获取基本信息

    qDebug() << "Page count:" << pdfDoc.pageCount();

    qDebug() << "PDF version:" << pdfDoc.pdfVersion();

    // 提取第一页文本

    QString pageText = pdfDoc.getAllText(0); // 第0页（索引从0开始）

    qDebug() << "Page 1 text:" << pageText.left(100) << "..."; // 输出前100字符

    // 将第二页渲染为图像

    QSize imageSize(1200, 1600); // 图像分辨率

    QImage pageImage = pdfDoc.render(1, imageSize); // 第1页

    pageImage.save("page2.png");

}

3.编辑 PDF 文件

核心类：QPdfWriter（生成新 PDF）、QPainter（绘制内容）

（1）创建新 PDF、添加文本/图形/水印。

#include <QPdfWriter>

#include <QPainter>

void createNewPdf(const QString &outputPath) {

    // 初始化 PDF 写入器

    QPdfWriter writer(outputPath);

    writer.setTitle("Demo PDF");

    writer.setPageSize(QPageSize(QPageSize::A4)); // A4 尺寸

    // 设置字体和颜色

    QPainter painter(&writer);

    QFont font("Arial", 12);

    painter.setFont(font);

    painter.setPen(Qt::blue);

    // 绘制文本

    painter.drawText(100, 100, "Hello, Qt PDF!");

    // 绘制图形（红色矩形）

    painter.setPen(Qt::red);

    painter.drawRect(QRect(100, 150, 200, 100));

    // 添加图像

    QImage logo(":/logo.png");

    painter.drawImage(QRect(100, 300, 200, 100), logo);

    painter.end(); // 结束绘制并保存文件

}

（2）修改现有 PDF（添加水印）

#include <QPdfDocument>

#include <QPdfWriter>

#include <QPainter>

void addWatermark(const QString &inputPath, const QString &outputPath) {

    // 加载原 PDF

    QPdfDocument pdfDoc;

    if (pdfDoc.load(inputPath) != QPdfDocument::Error::None) return;

    // 创建新 PDF 写入器

    QPdfWriter writer(outputPath);

    writer.setPageSize(QPageSize(QPageSize::A4));

    QPainter painter(&writer);

    painter.setRenderHint(QPainter::Antialiasing);

    // 逐页复制原内容并添加水印

    for (int i = 0; i < pdfDoc.pageCount(); ++i) {

        // 渲染原页面到图像

        QImage pageImage = pdfDoc.render(i, QSize(1200, 1600));

        

        // 绘制原页面内容

        painter.drawImage(0, 0, pageImage);

        

        // 添加水印文本

        painter.setPen(QColor(255, 0, 0, 100)); // 半透明白色

        painter.setFont(QFont("Arial", 48));

        painter.drawText(200, 400, "Confidential");

        

        // 换页（最后一页不换）

        if (i < pdfDoc.pageCount() - 1) {

            writer.newPage();

        }

    }

}

3.注意：

  QT自带的pdf模块实现了基本的读取、显示和简单标注功能，对于复杂的编辑操作（如修改文本内容、插入图片等），需要借助第三方库，例如 Poppler、MuPDF 等。