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查看应用程序,可以单独使用这些组件:PdfDocument、PdfPageImage、PdfPageNavigator、PdfSelection、PdfSearchModel、PdfLinkModel和PdfBookmarkModel。
如果您只需要渲染页面图像,而不需要文本选择、搜索和导航等功能,此模块包含一个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 许可。