详解Qt PDF 之 QPdfDocument与 QPdfView 打开与显示pdf

---

利用Qt PDF：QPdfDocument与QPdfView加载与显示PDF文档

引言

Qt PDF模块提供了一种功能强大的方法来加载、渲染和查看PDF文件。QPdfDocument类用于加载PDF文件并提供页面渲染功能，而QPdfView类则是一个方便的PDF查看控件，答应用户通过交互式界面查看PDF文档。本文将详细介绍如何利用QPdfDocument和QPdfView来加载和显示PDF文件。
1. QPdfDocument类

QPdfDocument类是用于加载和渲染PDF文档的核心类。通过该类，用户可以加载PDF文件，获取文档页面的元数据，渲染页面，提取文本信息等。
1.1 QPdfDocument的构造和加载文档

QPdfDocument的构造函数接受一个QObject类型的父对象，可以通过load()方法加载PDF文件。

1. QPdfDocument pdfDocument;
2. pdfDocument.load("/path/to/document.pdf");

复制代码

也可以从QIODevice中加载PDF文件：

1. QFile file("/path/to/document.pdf");
2. file.open(QIODevice::ReadOnly);
3. pdfDocument.load(&file);

复制代码

1.2 QPdfDocument的主要功能

• 页面计数和页面标签：可以通过pageCount()获取PDF的页面数，pageLabel()获取每一页的标签（用于显示在UI界面上）。
  

1. int pageCount = pdfDocument.pageCount();
2. QString pageLabel = pdfDocument.pageLabel(1); // 获取第一页的标签

复制代码

• 渲染页面：通过render()方法可以渲染页面为QImage，可用于显示或生存为图片。
  

1. QImage pageImage = pdfDocument.render(1, QSize(800, 600)); // 渲染第一页

复制代码

• 获取元数据：可以利用metaData()方法获取文档的元数据，比方标题、作者、创建日期等。
  

1. QVariant title = pdfDocument.metaData(QPdfDocument::MetaDataField::Title);

复制代码

1.3 错误处理和状态管理

QPdfDocument提供了error()方法，返回加载过程中的错误类型。此外，status()方法返回当前文档的状态（如加载中、已加载、加载失败等）。

1. if (pdfDocument.error() != QPdfDocument::Error::None) {
2.     qWarning() << "加载PDF时发生错误";
3. }

复制代码

2. QPdfView类

QPdfView是一个可视化的PDF查看控件，它答应用户在UI中查看PDF文档。它继承自QAbstractScrollArea，支持单页和多页视图模式，用户可以举行缩放和滚动操作。
2.1 QPdfView的构造和文档设置

要在QPdfView中显示PDF文档，首先必要设置QPdfDocument实例：

1. QPdfView *pdfView = new QPdfView(parent);
2. pdfView->setDocument(&pdfDocument);

复制代码

2.2 QPdfView的视图模式

QPdfView支持两种视图模式：

• 单页模式：每次显示一页PDF。
  
• 多页模式：连续显示多页PDF，用户可以滚动查看。
  

通过setPageMode()方法可以切换视图模式：

1. pdfView->setPageMode(QPdfView::PageMode::SinglePage);

复制代码

2.3 缩放功能

QPdfView提供了两种缩放模式：

• 自定义模式：利用zoomFactor()设置自定义的缩放因子。
  
• 顺应宽度：自动调整页面缩放，使页面宽度顺应控件的宽度。
  
• 顺应视图：自动调整页面缩放，使整个页面顺应控件的巨细。
  

可以利用setZoomMode()方法设置缩放模式：

1. pdfView->setZoomMode(QPdfView::ZoomMode::FitToWidth);

复制代码

2.4 控件的其他属性

• documentMargins：设置PDF视图的页面边距。
  
• pageSpacing：设置多页模式下页面之间的间距。
  
• zoomFactor：设置页面的缩放因子。
  

这些属性可通过相应的setter方法举行配置，比方：

1. pdfView->setDocumentMargins(QMargins(10, 10, 10, 10)); // 设置边距
2. pdfView->setPageSpacing(5); // 设置页面间距
3. pdfView->setZoomFactor(1.5); // 设置缩放因子

复制代码

3. 示例代码

以下是一个简单的示例，展示了如何利用QPdfDocument和QPdfView加载和显示PDF文档：

1. #include <QApplication>
2. #include <QPdfDocument>
3. #include <QPdfView>
4. #include <QFileDialog>
5. #include <QVBoxLayout>
6. #include <QWidget>
8. class PdfViewer : public QWidget {
9. public:
10.     PdfViewer(QWidget *parent = nullptr) : QWidget(parent) {
11.         pdfView = new QPdfView(this);
12.         pdfDocument = new QPdfDocument(this);
14.         QVBoxLayout *layout = new QVBoxLayout(this);
15.         layout->addWidget(pdfView);
17.         // 打开文件对话框选择PDF
18.         QString fileName = QFileDialog::getOpenFileName(this, "打开PDF文件", "", "PDF Files (*.pdf)");
19.         if (!fileName.isEmpty()) {
20.             pdfDocument->load(fileName);
21.             pdfView->setDocument(pdfDocument);
22.         }
24.         setLayout(layout);
25.     }
27. private:
28.     QPdfView *pdfView;
29.     QPdfDocument *pdfDocument;
30. };
32. int main(int argc, char *argv[]) {
33.     QApplication app(argc, argv);
35.     PdfViewer viewer;
36.     viewer.show();
38.     return app.exec();
39. }

复制代码

4. 总结

通过QPdfDocument和QPdfView，Qt为开发者提供了强大的PDF加载、渲染和查看功能。QPdfDocument负责加载和渲染PDF文档的内容，而QPdfView提供了直观的界面来显示这些内容。开发者可以轻松实现如PDF查看器等应用，满足不同的需求，如单页视图、多页视图、缩放功能和页面导航等。
Qt PDF模块是Qt 6引入的重要特性之一，它使得处理和显示PDF文件变得更为简便，并可以或许与Qt的其他功能（如QML和QtWidgets）无缝集成。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。