QPdfPageNavigator#

Navigation history within a PDF document. More…

Synopsis#

Properties#

backAvailable
currentLocation
currentPage
currentZoom
forwardAvailable

Functions#

def backAvailable ()
def currentLink ()
def currentLocation ()
def currentPage ()
def currentZoom ()
def forwardAvailable ()

Slots#

def back ()
def clear ()
def forward ()
def jump (destination)
def jump (page, location[, zoom=0])
def update (page, location, zoom)

Signals#

def backAvailableChanged (available)
def currentLocationChanged (location)
def currentPageChanged (page)
def currentZoomChanged (zoom)
def forwardAvailableChanged (available)
def jumped (current)

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

The QPdfPageNavigator class remembers which destinations the user has visited in a PDF document, and provides the ability to traverse backward and forward. It is used to implement back and forward actions similar to the back and forward buttons in a web browser.

See also

QPdfDocument

class PySide6.QtPdf.QPdfPageNavigator#

PySide6.QtPdf.QPdfPageNavigator(parent)

Parameters:: parent – PySide6.QtCore.QObject

Constructs a page navigation stack with parent object parent.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtPdf.QPdfPageNavigator.backAvailable: bool#

Holds true if a back destination is available in the history: that is, if push() or forward() has been called.

Access functions:

backAvailable ()
Signal backAvailableChanged (available)

property PᅟySide6.QtPdf.QPdfPageNavigator.currentLocation: PySide6.QtCore.QPointF#

This property holds the current location on the page that is being viewed (the location that was last given to jump() or update() ). The default is 0, 0.

Access functions:

currentLocation ()
Signal currentLocationChanged (location)

property PᅟySide6.QtPdf.QPdfPageNavigator.currentPage: int#

This property holds the current page that is being viewed. The default is 0.

Access functions:

currentPage ()
Signal currentPageChanged (page)

property PᅟySide6.QtPdf.QPdfPageNavigator.currentZoom: float#

This property holds the magnification scale (1 logical pixel = 1 point) on the page that is being viewed. The default is 1.

Access functions:

currentZoom ()
Signal currentZoomChanged (zoom)

property PᅟySide6.QtPdf.QPdfPageNavigator.forwardAvailable: bool#

Holds true if a forward destination is available in the history: that is, if back() has been previously called.

Access functions:

forwardAvailable ()
Signal forwardAvailableChanged (available)

PySide6.QtPdf.QPdfPageNavigator.back()#

Pops the stack, updates the currentPage , currentLocation and currentZoom properties to the most-recently-viewed destination, and then emits the jumped() signal.

PySide6.QtPdf.QPdfPageNavigator.backAvailable()#

Return type:: bool

Getter of property backAvailable .

PySide6.QtPdf.QPdfPageNavigator.backAvailableChanged(available)#

Parameters:: available – bool

Notification signal of property backAvailable .

PySide6.QtPdf.QPdfPageNavigator.clear()#

Clear the history and restore currentPage , currentLocation and currentZoom to their default values.

PySide6.QtPdf.QPdfPageNavigator.currentLink()#

Return type:: PySide6.QtPdf.QPdfLink

PySide6.QtPdf.QPdfPageNavigator.currentLocation()#

Return type:: PySide6.QtCore.QPointF

Getter of property currentLocation .

PySide6.QtPdf.QPdfPageNavigator.currentLocationChanged(location)#

Parameters:: location – PySide6.QtCore.QPointF

Notification signal of property currentLocation .

PySide6.QtPdf.QPdfPageNavigator.currentPage()#

Return type:: int

Getter of property currentPage .

PySide6.QtPdf.QPdfPageNavigator.currentPageChanged(page)#

Parameters:: page – int

Notification signal of property currentPage .

PySide6.QtPdf.QPdfPageNavigator.currentZoom()#

Return type:: float

Getter of property currentZoom .

PySide6.QtPdf.QPdfPageNavigator.currentZoomChanged(zoom)#

Parameters:: zoom – float

Notification signal of property currentZoom .

PySide6.QtPdf.QPdfPageNavigator.forward()#

Goes back to the page, location and zoom level that was being viewed before back() was called, and then emits the jumped() signal.

If a new destination was pushed since the last time back() was called, the forward() function does nothing, because there is a branch in the timeline which causes the “future” to be lost.

PySide6.QtPdf.QPdfPageNavigator.forwardAvailable()#

Return type:: bool

Getter of property forwardAvailable .

PySide6.QtPdf.QPdfPageNavigator.forwardAvailableChanged(available)#

Parameters:: available – bool

Notification signal of property forwardAvailable .

PySide6.QtPdf.QPdfPageNavigator.jump(destination)#

Parameters:: destination – PySide6.QtPdf.QPdfLink

Adds the given destination to the history of visited locations.

In this case, PDF views respond to the jumped signal by scrolling to place destination.rectangles in the viewport, as opposed to placing destination.location in the viewport. So it’s appropriate to call this method to jump to a search result from QPdfSearchModel (because the rectangles cover the region of text found). To jump to a hyperlink destination, call jump(page, location, zoom) instead, because in that case the QPdfLink object’s rectangles cover the hyperlink origin location rather than the destination.

PySide6.QtPdf.QPdfPageNavigator.jump(page, location[, zoom=0])

Parameters:

page – int
location – PySide6.QtCore.QPointF
zoom – float

Adds the given destination, consisting of page, location, and zoom, to the history of visited locations.

The zoom argument represents magnification (where 1 is the default scale, 1 logical pixel = 1 point). If zoom is not given or is 0, currentZoom keeps its existing value, and currentZoomChanged is not emitted.

The location should be the same as location() if the user is following a link; and since that is specified as the upper-left corner of the destination, it is best for consistency to always use the location visible in the upper-left corner of the viewport, in points.

If forwardAvailable is true, calling this function represents a branch in the timeline which causes the “future” to be lost, and therefore forwardAvailable will change to false.

PySide6.QtPdf.QPdfPageNavigator.jumped(current)#

Parameters:: current – PySide6.QtPdf.QPdfLink

This signal is emitted when an abrupt jump occurs, to the current page index, location on the page, and zoom level; but not when simply scrolling through the document one page at a time. That is, jump() , forward() and back() emit this signal, but update() does not.

If current.rectangles.length > 0, they are rectangles that cover a specific destination area: a search result that should be made visible; otherwise, current.location is the destination location on the page (a hyperlink destination, or during forward/back navigation).

PySide6.QtPdf.QPdfPageNavigator.update(page, location, zoom)#

Parameters:

page – int
location – PySide6.QtCore.QPointF
zoom – float

Modifies the current destination, consisting of page, location and zoom.

This can be called periodically while the user is manually moving around the document, so that after back() is called, forward() will jump back to the most-recently-viewed destination rather than the destination that was last specified by push().

The currentZoomChanged, currentPageChanged and currentLocationChanged signals will be emitted if the respective properties are actually changed. The jumped signal is not emitted, because this operation represents smooth movement rather than a navigational jump.