PdfMultiPageView QML 类型

一个完整的 PDF 查看器组件，可以滚动浏览多页。更多...

导入语句	import QtQuick.Pdf
继承自	Item

所有成员列表，包括继承成员

属性

backEnabled : bool
currentPage : int
currentPageRenderingStatus : int
document : PdfDocument
forwardEnabled : bool
pageRotation : real
renderScale : real
searchModel : PdfSearchModel
searchString : string
selectedText : string

方法

void back()
void copySelectionToClipboard()
void forward()
void goToLocation(int page, point location, real zoom)
void goToPage(int page)
void resetScale()
void scaleToPage(real width, real height)
void scaleToWidth(real width, real height)
void searchBack()
void searchForward()
void selectAll()

详细描述

PdfMultiPageView 提供了一个 PDF 查看器组件，提供了类似于许多常见 PDF 查看器应用程序的用户体验。它支持在整篇文档中浏览页面，页面图像之间有很小的缝隙。

PdfMultiPageView 还支持选择文本并将其复制到剪贴板，缩放显示，单击内部链接跳转到文档的另一个部分，旋转视图和搜索文本。 PDF 多页查看器示例演示了如何在应用程序中使用这些功能。

该实现是由可单独获取的小块构建而成的 QML 集成。如果您想修改您自己的组件版本，可以将安装在 QtQuick/Pdf/qml 模块目录中的 QML 复制出来，并按需修改。

另请参阅 PdfPageView，PdfScrollablePageView 和 PdfStyle。

属性文档

backEnabled : bool [只读]

此属性表示是否可以返回导航历史记录中的上一页。

另请参阅 PdfPageNavigator::backAvailable 和 back（）。

currentPage : int [只读]

该属性保存可滚动视图中可见页面的基于零的页码。如果没有当前页面，则保存 -1。

此属性是只读的，通常用于绑定（或 onCurrentPageChanged 脚本）以更新显示当前页码的用户界面部分，例如 SpinBox。

另请参阅 PdfPageNavigator::currentPage。

currentPageRenderingStatus : int

该属性保存当前页面的渲染状态。

document : PdfDocument [必需]

需要一个带有有效 source URL 的 PdfDocument 对象。

import QtQuick
import QtQuick.Pdf

PdfMultiPageView {
    document: PdfDocument { source: "my.pdf" }
}

forwardEnabled : bool [只读]

此属性指示是否可以前往导航历史中的下一个位置。

另请参阅 PdfPageNavigator::forwardAvailable 和 forward（）。

pageRotation : real

该属性保存页面的顺时针旋转。

默认值为 0 度（即相对于 PDF 文件中存储的页面方向无旋转）。

renderScale : real

该属性保存像素与点之间的比例。默认为 1，即一个点（1/72 英寸）等于 1 逻辑像素。

searchModel : PdfSearchModel

该属性保存包含给定 searchString 的搜索结果列表的 PdfSearchModel。

另请参阅 PdfSearchModel。

searchString : string

该属性保存用户可能选择的搜索字符串。它通常用于将 TextField 的 text 属性绑定。

另请参阅 searchModel。

selectedText : string

所选文本。

方法文档

void back()

将视图滚动到用户最近访问的上一页；如果没有导航堆栈中的上一位置，则不执行任何操作。

另请参阅 PdfPageNavigator::back()，currentPage，以及backEnabled。

void copySelectionToClipboard()

将选定的文本（如有）复制到系统剪贴板。

另请参阅 selectAll。

void forward()

将视图滚动到用户在调用back()方法时正在查看的页面；如果没有“下一页”的位置在导航堆栈中，则不做任何操作。

另请参阅 PdfPageNavigator::forward() 和 currentPage。

void goToLocation(int page, point location, real zoom)

如果可能的话，将视图滚动到页面上的位置，并设置缩放级别。

另请参阅 PdfPageNavigator::jump() 和 currentPage。

void goToPage(int page)

如果可能的话，将视图滚动到指定的页面号。

另请参阅 PdfPageNavigator::jump() 和 currentPage。

void resetScale()

将 renderScale 重置为其默认值 1。

void scaleToPage(real width, real height)

将 renderScale 设置为使得整个第一页可以适应给定宽度和高度的视口。最终的 renderScale 依赖于 pageRotation：如果首先旋转以匹配长宽比，则页面将更大的尺寸适应视口。

void scaleToWidth(real width, real height)

将 renderScale 设置为使得第一页的宽度可以适应给定宽度和高度的视口。如果页面没有旋转，它将被缩放以使其宽度适应宽度。如果旋转 +/- 90 度，它将被缩放以使其宽度适应高度。

void searchBack()

将searchModel的当前结果递减，以便使视图跳转到上一个搜索结果。

void searchForward()

将searchModel的当前结果递增，以便使视图跳转到下一个搜索结果。

void selectAll()

选择当前页面上的所有文本，并在支持此功能的系统上将其作为系统选择可用。

另请参阅 copySelectionToClipboard。