Qt PDF

Qt PDF 模块包含用于渲染 PDF 文档的类和函数。类 QPdfDocument 加载 PDF 文档，并根据类 QPdfDocumentRenderOptions 提供的选项渲染页面。类 QPdfPageRenderer 管理一个队列，收集所有渲染请求。类 QPdfPageNavigator 处理 PDF 文档的导航。类 QPdfSearchModel 搜索字符串并保留搜索结果。类 QPdfBookmarkModel 饱含（如果存在）目录。类 QPdfLinkModel 包含页面上的超链接信息。小部件 QPdfView 是一个完整的 PDF 阅读者，以及 PDF 阅读者小部件示例如何使用它。

对于 Qt Quick 应用程序，提供了三种全功能的阅读器组件。建议您首先选择 PdfMultiPageView 以获得最常见用户体验：通过整个文档翻页。每页一次显示的 PdfScrollablePageView，并且 PdfPageView 不允许滚动，每次显示一整页。

全功能阅读器组件由更低级别的 QML 组件组成，可单独使用以撰写更定制的 PDF 阅读应用程序：类 PdfDocument、类 PdfPageImage、类 PdfPageNavigator、类 PdfSelection、类 PdfSearchModel、类 PdfLinkModel 和类 PdfBookmarkModel。

如果您只需要渲染页面图像，而不需要文本选择、搜索和导航等功能，该模块包括一个 QImageIOHandler 插件，将 PDF 处理为一个可缩放图像格式，类似于 SVG。您可以使用简单的 Image，并将 currentFrame 属性设置为要显示的页面索引。如果 PDF 文件没有渲染其自己的背景，则图像具有透明背景。

使用模块

使用 Qt 模块需要链接到模块库，无论是直接还是通过其他依赖项。包括 CMake 和 qmake 在内的一些构建工具为此提供了专门的支持。

使用 CMake 构建

使用 find_package() 命令在 Qt6 软件包中定位所需的模块组件

find_package(Qt6 REQUIRED COMPONENTS Pdf)
target_link_libraries(mytarget Qt6::Pdf)

请参阅使用CMake构建概述。

使用qmake构建

要链接到模块，请将此行添加到您的qmake项目文件中

QT += pdf

示例

Qt PDF 示例

API 参考信息

文章和指南

{Qt PDF 平台说明} {平台说明}

许可和归属

Qt PDF 可在商业许可下从 Qt 公司获得许可。此外，它还可在GNU Lesser General Public License版本3或GNU General Public License版本2下获得许可。有关此模块的更多详细信息，请参阅Qt PDF 许可。