PdfPageNavigator QML Type

Verlauf der besuchten Ziele innerhalb eines PDF-Dokuments. Mehr...

Import Statement: import QtQuick.Pdf

Eigenschaften

Signale

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

Methoden

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

Detaillierte Beschreibung

PdfPageNavigator merkt sich, welche Ziele der Benutzer in einem PDF-Dokument besucht hat, und bietet die Möglichkeit, vorwärts und rückwärts zu navigieren.

Eigenschaft Dokumentation

backAvailable : bool [read-only]

Enthält true, wenn ein Rückwärtsziel in der Historie verfügbar ist.


currentLocation : point

Diese Eigenschaft speichert die aktuelle Position auf der Seite, die gerade angezeigt wird.


currentPage : int

Diese Eigenschaft enthält die aktuelle Seite, die gerade angezeigt wird. Wenn es keine aktuelle Seite gibt, enthält sie -1.


currentZoom : real

Diese Eigenschaft enthält den Vergrößerungsmaßstab auf der angezeigten Seite.


forwardAvailable : bool [read-only]

Enthält true, wenn ein Vorwärtsziel in der Historie verfügbar ist.


Signal Dokumentation

jumped(int page, point location, qreal zoom)

Dieses Signal wird ausgegeben, wenn ein abrupter Sprung zum angegebenen Index page, zur Seite location und zur Ebene zoom erfolgt, nicht aber beim einfachen Blättern durch das Dokument nach und nach. Das heißt, forward(), back() und jump() geben dieses Signal immer aus; update() nicht.

Hinweis: Der entsprechende Handler ist onJumped.


Dokumentation der Methode

void back()

Öffnet den Stapel, aktualisiert die Eigenschaften currentPage, currentLocation und currentZoom auf das zuletzt angezeigte Ziel und gibt dann das Signal jumped() aus.


void forward()

Kehrt zu der Seite, dem Ort und der Zoomstufe zurück, die vor dem Aufruf von back() angezeigt wurden, und gibt dann das Signal jumped() aus.

Wenn seit dem letzten Aufruf von back() ein neues Ziel eingefügt wurde, bewirkt die Funktion forward() nichts, da es eine Verzweigung in der Zeitleiste gibt, durch die die "Zukunft" verloren geht.


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

Fügt das angegebene Ziel, bestehend aus page, location und zoom, zur Historie der besuchten Orte hinzu. Wenn emitJumped false ist, wird das Signal jumped() nicht ausgegeben.

Wenn forwardAvailable gleich true ist, stellt der Aufruf dieser Funktion eine Verzweigung in der Zeitlinie dar, die dazu führt, dass die "Zukunft" verloren geht, und daher wird forwardAvailable in false geändert.


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

Ändert das aktuelle Ziel, bestehend aus page, location und zoom.

Diese Funktion kann in regelmäßigen Abständen aufgerufen werden, während der Benutzer sich manuell im Dokument bewegt, so dass nach dem Aufruf von back() forward() zum zuletzt angezeigten Ziel zurückspringt und nicht zu dem Ziel, das zuletzt mit jump() angegeben wurde.

Die Signale currentZoomChanged, currentPageChanged und currentLocationChanged werden ausgegeben, wenn die entsprechenden Eigenschaften tatsächlich geändert werden. Das Signal jumped wird nicht ausgegeben, da dieser Vorgang eher eine gleichmäßige Bewegung als einen Navigationssprung darstellt.


© 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.