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构建使用CMake构建

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

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

请参阅使用CMake构建概述。

使用qmake构建使用qmake构建

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

QT += pdf

示例#

API 参考#

文章和指南#

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

许可证和归属#

Qt PDF 可在 The Qt Company 的商业许可证下使用。此外,它还可在 GNU Lesser General Public License 版本 3 或 GNU General Public License 版本 2 下使用。有关此模块的更多详细信息,请参阅 Qt PDF 许可证

类列表#