PdfPageView QML Type
一次显示一页的 PDF 查看器组件。更多
Import Statement: | import QtQuick.Pdf |
Inherits: |
属性
- 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 。
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 个点(1/72 英寸)等于 1 个逻辑像素。
searchModel : PdfSearchModel |
该属性保存一个PdfSearchModel ,其中包含给定searchString 的搜索结果列表。
另请参阅 PdfSearchModel 。
searchString : string |
该属性包含用户可选择搜索的搜索字符串。它通常用于与TextField 的text
属性绑定。
另请参阅 searchModel 。
selectedText : PdfDocument |
选定文本。
sourceSize : size |
该属性包含全帧图像的缩放宽度和高度。
另请参阅 Image.sourceSize 。
status : int |
该属性用于保存current page 的rendering status 。
zoomEnabled : bool |
该属性显示用户是否可以使用捏合手势或 Control + 鼠标滚轮来缩放。默认为true
。
当用户缩放页面时,PdfPageView 的大小会发生变化。
方法文档
void back() |
将视图滚动到用户最近访问过的上一页;如果导航栈中没有上一页,则不滚动。
另请参阅 PdfPageNavigator::back()、currentPage 和backEnabled 。
void copySelectionToClipboard() |
将所选文本(如果有)复制到system clipboard 。
另请参阅 selectAll()。
void forward() |
将视图滚动到调用back() 方法时用户正在查看的页面;如果导航栈中没有 "下一个 "位置,则不滚动。
另请参阅 PdfPageNavigator::forward() 和currentPage 。
如果可能,将视图滚动到page 上的location ,并设置zoom 级别。
另请参阅 PdfPageNavigator::jump() 和currentPage 。
void goToPage(int page) |
如果可能,将视图更改为page 。
另请参阅 PdfPageNavigator::jump() 和currentPage 。
void resetScale() |
将renderScale 设回默认值1
。
设置renderScale ,使整个第一页适合与给定的width 和height 视口相匹配。renderScale 的结果取决于页面的旋转:如果先旋转页面,使其具有匹配的宽高比,则页面将以更大的尺寸放入视口。
设置renderScale ,使第一页的宽度适合给定的width 和height 的视口。如果页面未旋转,则会按比例调整,使其宽度适合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.