PdfMultiPageView QML Type

用于滚动浏览多个页面的完整 PDF 查看器组件。更多

Import Statement: import QtQuick.Pdf
Inherits:

Item

属性

方法

详细说明

PdfMultiPageView 提供了一个 PDF 浏览器组件,可为用户提供与许多常见 PDF 浏览器应用程序类似的体验。它支持在整个文档中翻阅页面,页面图像之间的间隙很窄。

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

该实现是由单独提供的较小构件组成的 QML 组件。如果您想在自己的版本中对该组件进行修改,可以复制安装在QtQuick/Pdf/qml 模块目录下的 QML,并根据需要对其进行修改。

另请参阅 PdfPageView,PdfScrollablePageView, 和PdfStyle

属性文档

backEnabled : bool [read-only]

该属性表示是否可以在导航历史中返回到之前浏览过的页面。

另请参阅 PdfPageNavigator::backAvailableback() 。


currentPage : int [read-only]

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

该属性为只读属性,通常在绑定(或onCurrentPageChanged 脚本)中用于更新显示当前页码的用户界面部分,如SpinBox

另请参阅 PdfPageNavigator::currentPage


currentPageRenderingStatus : int

该属性保存current pagerendering status


document : PdfDocument [required]

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

import QtQuick
import QtQuick.Pdf

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

forwardEnabled : bool [read-only]

该属性表示是否可以转到导航历史中的下一个位置。

另请参阅 PdfPageNavigator::forwardAvailableforward()。


pageRotation : real

该属性表示页面的顺时针旋转角度。

默认值为0 度(即相对于存储在 PDF 文件中的页面方向不旋转)。


renderScale : real

该属性表示像素与点的比例。默认值为1 ,即 1 个点(1/72 英寸)等于 1 个逻辑像素。


searchModel : PdfSearchModel

该属性包含一个PdfSearchModel ,其中包含给定searchString 的搜索结果列表。

另请参阅 PdfSearchModel


searchString : string

该属性包含用户可选择搜索的搜索字符串。它通常用于与TextFieldtext 属性绑定。

另请参阅 searchModel


selectedText : PdfDocument

所选文本。


方法文档

void back()

将视图滚动到用户最近访问过的上一页;如果导航栈中没有上一页,则不滚动。

另请参阅 PdfPageNavigator::back()、currentPagebackEnabled


void copySelectionToClipboard()

将所选文本(如果有)复制到system clipboard

另请参阅 selectAll()。


void forward()

将视图滚动到调用back() 方法时用户正在查看的页面;如果导航栈中没有 "下一个 "位置,则不滚动。

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


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

如果可能,将视图滚动到page 上的location ,并设置zoom 级别。

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


void goToPage(int page)

如果可能,将视图滚动到给定的page 编号。

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


void resetScale()

renderScale 设回默认值1


void scaleToPage(real width, real height)

设置renderScale ,使整个第一页都能与给定的widthheight 相匹配。renderScale 的结果取决于pageRotation :如果先旋转页面使其具有匹配的宽高比,则页面将以更大的尺寸放入视口。


void scaleToWidth(real width, real height)

设置renderScale ,使第一页的宽度与给定的widthheight 的视口相匹配。如果页面没有旋转,则会按比例调整宽度,使其与width 相匹配。如果旋转 +/- 90 度,将按比例缩放,使其宽度适合height


void searchBack()

减少searchModel's current result ,使视图跳转到上一个搜索结果。


void searchForward()

增加searchModel's current result ,使视图跳转到下一个搜索结果。


void selectAll()

选择current page 上的所有文本,并在支持该功能的系统上将其作为系统selection

另请参阅 copySelectionToClipboard() 。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.