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 等。