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 许可证。