QPdfPageNavigator Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen Seitennavigationsstapel mit dem übergeordneten Objekt parent.

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

Zerstört den Navigationsstapel der Seite.

[slot] void QPdfPageNavigator::back()

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

[slot] void QPdfPageNavigator::clear()

Löschen Sie den Verlauf und setzen Sie currentPage, currentLocation und currentZoom auf ihre Standardwerte zurück.

[slot] void QPdfPageNavigator::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.

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

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

Fügt die angegebene destination zur Historie der besuchten Orte hinzu.

In diesem Fall reagieren PDF-Ansichten auf das Signal jumped mit einem Bildlauf, um destination.rectangles im Ansichtsfenster zu platzieren, im Gegensatz zu destination.location im Ansichtsfenster. Daher ist es angebracht, diese Methode aufzurufen, um von QPdfSearchModel zu einem Suchergebnis zu springen (da die Rechtecke den gefundenen Textbereich abdecken). Um zu einem Hyperlink-Ziel zu springen, rufen Sie stattdessen jump(page, location, zoom) auf, da in diesem Fall die rectangles des QPdfLink -Objekts den Ursprungsort des Hyperlinks und nicht den Zielort abdeckt.

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

Fügt das angegebene Ziel, bestehend aus page, location und zoom, zur Liste der besuchten Orte hinzu.

Das Argument zoom steht für die Vergrößerung (wobei 1 der Standardmaßstab ist, 1 logischer Pixel = 1 Punkt). Wenn zoom nicht angegeben wird oder 0 ist, behält currentZoom seinen bestehenden Wert, und currentZoomChanged wird nicht ausgegeben.

location sollte derselbe Wert sein wie QPdfLink::location(), wenn der Benutzer einem Link folgt; und da dies als obere linke Ecke des Ziels angegeben wird, ist es aus Gründen der Konsistenz am besten, immer die in der oberen linken Ecke des Ansichtsfensters sichtbare Position in Punkten zu verwenden.

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

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

Dieses Signal wird ausgegeben, wenn ein abrupter Sprung zum current Seitenindex, zur Position auf der Seite und zur Zoomstufe erfolgt, aber nicht, wenn einfach seitenweise durch das Dokument geblättert wird. Das heißt, jump(), forward() und back() geben dieses Signal aus, update() jedoch nicht.

Bei current.rectangles.length > 0 handelt es sich um Rechtecke, die einen bestimmten Zielbereich abdecken: ein Suchergebnis, das sichtbar gemacht werden soll; andernfalls ist current.location die Zielposition auf page (ein Hyperlink-Ziel oder bei der Vorwärts-/Rückwärtsnavigation).

[slot] void QPdfPageNavigator::update(int page, const QPointF &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 push() 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 diese Operation eher eine sanfte Bewegung als einen Navigationssprung darstellt.