PdfPageView QML 类型

一个一次显示一页的 PDF 查看器组件。更多...

导入语句	import QtQuick.Pdf
继承	Rectangle

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

属性

backEnabled : bool
currentPage : int
document : PdfDocument
forwardEnabled : bool
renderScale : real
searchModel : PdfSearchModel
searchString : string
selectedText : PdfDocument
sourceSize : size
status : int
zoomEnabled : bool

方法

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()

详细说明

PdfPageView 提供了一个 PDF 查看器组件，每次显示整页，不需要滚动。它支持选择文本并将其复制到剪贴板，放大和缩小，点击内部链接跳转到文档的另一个部分，旋转视图和搜索文本。

实现是一个由更小的构建块组成的 QML 组装体，这些构建块可以分别使用。如果你想在组件的自己的版本中做更改，你可以复制安装到 QtQuick/Pdf/qml 模块目录中的 QML，并根据需要修改它。

另请参阅 PdfScrollablePageView、PdfMultiPageView 以及 PdfStyle。

属性文档

backEnabled : bool [只读]

此属性指示是否可以回退到导航历史中的上一页。

另请参阅 PdfPageNavigator::backAvailable 和 back 方法。

currentPage : int [只读]

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

此属性为只读，通常用于在绑定（或 onCurrentPageChanged 脚本）中更新显示当前页面号的用户界面部分，例如一个 SpinBox。

另请参阅 PdfPageNavigator::currentPage。

document : PdfDocument [必需]

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

import QtQuick
import QtQuick.Pdf

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

forwardEnabled : bool [只读]

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

另请参阅 PdfPageNavigator::forwardAvailable 和 forward 方法。

renderScale : real

此属性保存像素与点之间的比率。默认值为 1，表示一点（1/72英寸）等于一个逻辑像素。

searchModel : PdfSearchModel

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

另请参阅 PdfSearchModel。

searchString : string

此属性保存用户可以用于搜索的搜索字符串。它通常用于绑定到 TextField 的 text 属性。

另请参阅 searchModel。

selectedText : PdfDocument

所选文本。

sourceSize : size

此属性保存全帧图像缩放的宽度和高度。

另请参阅 Image.sourceSize。

status : int

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

zoomEnabled : bool

此属性保存用户是否可以使用捏合手势或 Control + 鼠标滚轮来缩放。默认为 true。

当用户缩放页面时，PdfPageView 的大小会改变。

方法文档

void back()

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

另请参阅 PdfPageNavigator::back()、currentPage 和 backEnabled。

void copySelectionToClipboard()

如果选中了文本，则将其复制到系统剪贴板。

另请参阅selectAll方法。

void forward()

将视图滚动到用户在使用back()方法时所在的页面；如果没有“下一个”位置在导航堆栈中，则什么都不做。

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

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

如果可能，将视图滚动到location处并且在page上，并设置zoom级别。

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

void goToPage(int page)

如果可能，将视图更改为page。

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

void resetScale()

将renderScale设置回默认值1。

void scaleToPage(real width, real height)

设置renderScale，使得整个第一页能适应具有给定width和height的视口中。结果的renderScale取决于页面旋转：如果页面首先旋转以匹配宽高比，它将适应视口以更大的大小。

void scaleToWidth(real width, real height)

设置renderScale，使得第一页的宽度能适应具有给定width和height的视口中。如果不旋转页面，将会将其缩放以使其宽度适应该width。如果它旋转+/−90度，它将缩放以使其宽度适应height。

void searchBack()

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

void searchForward()

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

void selectAll()

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

另请参阅copySelectionToClipboard方法。