PdfPageNavigator QML Type

Historique des destinations visitées dans un document PDF. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• backAvailable : bool
• currentLocation : point
• currentPage : int
• currentZoom : real
• forwardAvailable : bool

Signaux

• jumped(int page, point location, qreal zoom)

Méthodes

• void back()
• void forward()
• void jump(int page, point location, qreal zoom, bool emitJumped)
• void update(int page, point location, qreal zoom)

Description détaillée

PdfPageNavigator se souvient des destinations que l'utilisateur a visitées dans un document PDF et offre la possibilité de naviguer en avant et en arrière.

Documentation sur les propriétés

backAvailable : bool [read-only]

Tient true si une destination de retour est disponible dans l'historique.

currentLocation : point

Cette propriété indique l'emplacement actuel sur la page en cours de visualisation.

currentPage : int

Cette propriété contient la page en cours d'affichage. S'il n'y a pas de page en cours, elle contient -1.

currentZoom : real

Cette propriété contient l'échelle d'agrandissement de la page visualisée.

forwardAvailable : bool [read-only]

Tient true si une destination de transfert est disponible dans l'historique.

Documentation sur les signaux

jumped(int page, point location, qreal zoom)

Ce signal est émis lorsqu'un saut brusque se produit, à l'index page spécifié, à location sur la page et au niveau zoom; mais pas lorsqu'on fait simplement défiler le document une page à la fois. Autrement dit, forward(), back() et jump() émettent toujours ce signal, mais pas update().

Documentation de la méthode

void back()

Ouvre la pile, met à jour les propriétés currentPage, currentLocation et currentZoom en fonction de la destination la plus récemment consultée, puis émet le signal jumped().

void forward()

Retourne à la page, à l'emplacement et au niveau de zoom qui étaient affichés avant l'appel de back(), puis émet le signal jumped().

Si une nouvelle destination a été poussée depuis le dernier appel à back(), la fonction forward() ne fait rien, parce qu'il y a un embranchement dans la ligne temporelle qui fait perdre le "futur".

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

Ajoute la destination donnée, composée de page, location, et zoom, à l'historique des lieux visités. Si emitJumped est false, le signal jumped() ne sera pas émis.

Si forwardAvailable est true, l'appel de cette fonction représente un embranchement dans la ligne temporelle qui fait perdre le "futur", et donc forwardAvailable deviendra false.

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

Modifie la destination actuelle, composée de page, location et zoom.

Cette fonction peut être appelée périodiquement lorsque l'utilisateur se déplace manuellement dans le document, de sorte qu'après l'appel de back(), forward() reviendra à la destination la plus récemment affichée plutôt qu'à la dernière destination spécifiée par jump().

Les signaux currentZoomChanged, currentPageChanged et currentLocationChanged seront émis si les propriétés respectives sont effectivement modifiées. Le signal jumped n'est pas émis, car cette opération représente un mouvement fluide plutôt qu'un saut de navigation.