PdfPageNavigator QML类型

记录PDF文档中访问过的目的地的历史。更多...

导入语句	import QtQuick.Pdf

属性

PdfPageNavigator会记住用户在PDF文档中访问过的哪些目的地，并提供向后和向前导航的能力。

backAvailable : bool [只读]

如果历史记录中有一个可用的后退目的地，则保留值为true。

currentLocation : point

此属性保留正在查看的页面上的当前位置。

currentPage : int

此属性保留正在查看的当前页面。如果没有当前页面，则保留-1。

currentZoom : real

此属性保留正在查看的页面上的放大比例。

forwardAvailable : bool [只读]

如果历史记录中有一个可用的向前目的地，则保留值为true。

jumped(int page, point location, qreal zoom)

当一个跳跃发生时发出此信号，跳转到指定的page索引、页面上的location和zoom级别；但是不是在简单滚动文档一次一页时。也就是说，forward()、back()和jump()总是发出此信号；update()则不会。

注意：相应的处理程序是 onJumped。

void back()

弹出堆栈，将 currentPage、currentLocation 和 currentZoom 属性更新为最近查看的目的地，然后发出 jumped() 信号。

void forward()

回到之前调用 back() 之前的页面、位置和缩放级别，然后发出 jumped() 信号。

如果从上次调用 back() 以来已经推入新的目的地，则 forward() 函数将不执行任何操作，因为这会导致时间线中的“未来”丢失。

void jump(int page, point location, qreal zoom, bool emitJumped)

将给定的由 page、location 和 zoom 组成的目的地添加到已访问位置的历史记录中。如果 emitJumped 是 false，则不会发出 jumped() 信号。

如果 forwardAvailable 是 true，调用此函数表示时间线中的一个分支，会导致“未来”丢失，因此 forwardAvailable 将更改为 false。

void update(int page, point location, qreal zoom)

修改由 page、location 和 zoom 组成的当前目的地。

当用户正在手动在文档中移动时，可以定期调用此函数，以便在调用 back() 之后，forward() 能够跳转到最近查看的目的地，而不是 jump() 最后指定的目的地。

如果相应的属性实际上已更改，则将发出 currentZoomChanged、currentPageChanged 和 currentLocationChanged 信号。由于此操作表示平滑移动而不是导航跳转，因此不会发出 jumped 信号。