PySide6.QtPdf

详细描述

从PDF文档渲染页面。

Qt PDF 模块包含用于渲染 PDF 文档的类和函数。QPdfDocument 类加载 PDF 文档并根据 QPdfDocumentRenderOptions 类提供的选项渲染页面。QPdfPageRenderer 类管理一个收集所有渲染请求的队列。QPdfPageNavigator 类处理 PDF 文档的导航。QPdfSearchModel 类搜索字符串并保存搜索结果。QPdfBookmarkModel 类保存目录(如果存在)。QPdfLinkModel 保存页面上的超链接信息。QPdfView 小部件是一个完整的 PDF 查看器,PDF Viewer Widget Example 展示了如何使用它。

对于Qt Quick应用程序,提供了三种功能齐全的查看器组件。PdfMultiPageView应该是您最常见的用户体验的首选:翻阅整个文档的页面。PdfScrollablePageView一次显示一页,带有滚动功能;而PdfPageView一次显示一整页,没有滚动功能。

功能齐全的查看器组件由较低级别的QML组件组成,如果您需要编写更定制的PDF查看应用程序,可以单独使用这些组件:PdfDocumentPdfPageImagePdfPageNavigatorPdfSelectionPdfSearchModelPdfLinkModelPdfBookmarkModel

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

使用模块

使用Qt模块需要链接到模块库,无论是直接链接还是通过其他依赖项。几种构建工具对此有专门的支持,包括CMake和qmake。

使用CMake构建

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

<Code snippet "/data/qt5-full-681/6.8.1/Src/qtbase/qtpdf-build.cmake" not found>

另请参阅使用 CMake 构建的概述。

使用qmake构建

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

QT += pdf

示例

API参考

文章和指南

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

许可证和归属

Qt PDF 可从 The Qt Company 获得商业许可。此外,它还可在 GNU 宽通用公共许可证第 3 版或 GNU 通用公共许可证第 2 版下使用。有关此模块的更多详细信息,请参阅 Qt PDF 许可

班级列表