QPdfPageNavigator Class

成员函数 文档

[explicit] QPdfPageNavigator::QPdfPageNavigator(QObject *parent)

通过父对象parent 构建页面导航栈。

[override virtual noexcept] QPdfPageNavigator::~QPdfPageNavigator()

销毁页面导航堆栈。

[slot] void QPdfPageNavigator::back()

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

[slot] void QPdfPageNavigator::clear()

清除历史记录，并将currentPage 、currentLocation 和currentZoom 恢复为默认值。

[slot] void QPdfPageNavigator::forward()

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

如果在上次调用back() 之后又推送了新的目的地，forward() 函数将不起任何作用，因为时间轴上的分支会导致 "未来 "丢失。

[slot] void QPdfPageNavigator::jump(QPdfLink destination)

将给定的destination 添加到历史访问位置中。

在这种情况下，PDF 视图对jumped 信号的响应是通过滚动将destination.rectangles 放在视口中，而不是将destination.location 放在视口中。因此，调用此方法从QPdfSearchModel 跳转到搜索结果是合适的（因为矩形覆盖了找到的文本区域）。如果要跳转到超链接的目的地，则应调用 jump(page,location,zoom)，因为在这种情况下，QPdfLink 对象的rectangles 会覆盖超链接的起始位置，而不是目的地。

[slot] void QPdfPageNavigator::jump(int page, const QPointF &location, qreal zoom = 0)

将给定的目的地（由page 、location 和zoom 组成）添加到已访问位置的历史记录中。

zoom 参数表示放大倍数（其中1 为默认比例，1 逻辑像素 = 1 点）。如果zoom 未给出或为0 ，currentZoom 将保留其现有值，而currentZoomChanged 将不会发出。

如果用户跟踪的是链接，location 应与QPdfLink::location() 相同；由于指定的是目的地的左上角，为了保持一致，最好始终使用视口左上角可见的位置（以点为单位）。

如果forwardAvailable 是true ，调用此函数表示时间轴上的一个分支，会导致 "未来 "丢失，因此forwardAvailable 将变为false 。

[signal] void QPdfPageNavigator::jumped(QPdfLink current)

当发生突然跳转时，current 页面索引、页面上的位置和缩放级别都会发出这个信号；但如果只是一页一页地滚动浏览文档，则不会发出这个信号。也就是说，jump() 、forward() 和back() 会发出这个信号，但update() 不会。

如果是current.rectangles.length > 0 ，它们是覆盖特定目标区域的矩形：应使其可见的搜索结果；否则，current.location 是page 上的目标位置（超链接目标，或在向前/向后导航过程中）。

[slot] void QPdfPageNavigator::update(int page, const QPointF &location, qreal zoom)

修改当前目的地，包括page 、location 和zoom 。

当用户在文档中手动移动时，可以定期调用此功能，这样在调用back() 后，forward() 将跳回最近查看的目标地址，而不是上次由 push() 指定的目标地址。

如果实际更改了相应的属性，则会发出currentZoomChanged 、currentPageChanged 和currentLocationChanged 信号。jumped 信号不会发出，因为该操作代表的是平滑移动，而不是导航跳转。