PdfMultiPageView QML Type

Eine vollständige PDF-Viewer-Komponente zum Blättern durch mehrere Seiten. Mehr...

Import Statement: import QtQuick.Pdf
Inherits:

Item

Eigenschaften

Methoden

Detaillierte Beschreibung

PdfMultiPageView ist eine PDF-Viewer-Komponente, die ein ähnliches Benutzererlebnis wie viele gängige PDF-Viewer-Anwendungen bietet. Sie unterstützt das Blättern durch die Seiten des gesamten Dokuments, mit schmalen Lücken zwischen den Seitenbildern.

PdfMultiPageView unterstützt auch das Auswählen von Text und das Kopieren in die Zwischenablage, das Vergrößern und Verkleinern, das Anklicken eines internen Links, um zu einem anderen Abschnitt im Dokument zu springen, das Drehen der Ansicht und die Suche nach Text. Das PDF Multipage Viewer Beispiel zeigt, wie diese Funktionen in einer Anwendung genutzt werden können.

Die Implementierung ist eine QML-Assembly aus kleineren Bausteinen, die separat erhältlich sind. Falls Sie in Ihrer eigenen Version dieser Komponente Änderungen vornehmen möchten, können Sie die QML, die im Modulverzeichnis QtQuick/Pdf/qml installiert ist, kopieren und nach Bedarf modifizieren.

Siehe auch PdfPageView, PdfScrollablePageView, und PdfStyle.

Eigenschaft Dokumentation

backEnabled : bool [read-only]

Diese Eigenschaft gibt an, ob es möglich ist, in der Navigationshistorie zu einer zuvor angezeigten Seite zurückzugehen.

Siehe auch PdfPageNavigator::backAvailable und back().


currentPage : int [read-only]

Diese Eigenschaft enthält die auf Null basierende Seitennummer der Seite, die in der scrollbaren Ansicht sichtbar ist. Wenn es keine aktuelle Seite gibt, hat sie den Wert -1.

Diese Eigenschaft ist schreibgeschützt und wird typischerweise in einer Bindung (oder einem onCurrentPageChanged Skript) verwendet, um den Teil der Benutzeroberfläche zu aktualisieren, der die aktuelle Seitenzahl anzeigt, wie z. B. SpinBox.

Siehe auch PdfPageNavigator::currentPage.


currentPageRenderingStatus : int

Diese Eigenschaft enthält die rendering status der current page.


document : PdfDocument [required]

Ein PdfDocument Objekt mit einer gültigen source URL ist erforderlich:

import QtQuick
import QtQuick.Pdf

PdfMultiPageView {
    document: PdfDocument { source: "my.pdf" }
}

forwardEnabled : bool [read-only]

Diese Eigenschaft gibt an, ob es möglich ist, zur nächsten Position in der Navigationshistorie zu gehen.

Siehe auch PdfPageNavigator::forwardAvailable und forward().


pageRotation : real

Diese Eigenschaft gibt die Drehung der Seiten im Uhrzeigersinn an.

Der Standardwert ist 0 (d. h. keine Drehung relativ zur Ausrichtung der Seiten, wie sie in der PDF-Datei gespeichert sind).


renderScale : real

Diese Eigenschaft gibt das Verhältnis von Pixeln zu Punkten an. Der Standardwert ist 1, was bedeutet, dass ein Punkt (1/72 Zoll) 1 logischem Pixel entspricht.


searchModel : PdfSearchModel

Diese Eigenschaft enthält eine PdfSearchModel, die die Liste der Suchergebnisse für eine bestimmte searchString enthält.

Siehe auch PdfSearchModel.


searchString : string

Diese Eigenschaft enthält den Suchstring, den der Benutzer für die Suche auswählen kann. Sie wird typischerweise in einer Bindung an die text Eigenschaft einer TextField verwendet.

Siehe auch searchModel.


selectedText : PdfDocument

Der ausgewählte Text.


Methode Dokumentation

void back()

Blättert die Ansicht zurück zur vorherigen Seite, die der Benutzer zuletzt besucht hat; oder tut nichts, wenn es keine vorherige Position auf dem Navigationsstapel gibt.

Siehe auch PdfPageNavigator::back(), currentPage, und backEnabled.


void copySelectionToClipboard()

Kopiert den markierten Text (falls vorhanden) in den system clipboard.

Siehe auch selectAll().


void forward()

Blättert die Ansicht zu der Seite, die der Benutzer beim Aufruf der Methode back() angezeigt hat; oder tut nichts, wenn es keine "nächste" Stelle auf dem Navigationsstapel gibt.

Siehe auch PdfPageNavigator::forward() und currentPage.


void goToLocation(int page, point location, real zoom)

Scrollt die Ansicht zur location auf der page, wenn möglich, und setzt die zoom Ebene.

Siehe auch PdfPageNavigator::jump() und currentPage.


void goToPage(int page)

Blättert in der Ansicht zur angegebenen page Nummer, falls möglich.

Siehe auch PdfPageNavigator::jump() und currentPage.


void resetScale()

Setzt renderScale auf seinen Standardwert 1 zurück.


void scaleToPage(real width, real height)

Setzt renderScale so, dass die gesamte erste Seite in ein Ansichtsfenster mit den angegebenen width und height passt. Das Ergebnis von renderScale hängt von pageRotation ab: Die Seite wird in das Ansichtsfenster mit einer größeren Größe passen, wenn sie zuerst gedreht wird, um ein passendes Seitenverhältnis zu erhalten.


void scaleToWidth(real width, real height)

Setzt renderScale so, dass die Breite der ersten Seite in ein Ansichtsfenster mit den angegebenen width und height passt. Wenn die Seite nicht gedreht wird, wird sie so skaliert, dass ihre Breite in width passt. Wenn sie um +/- 90 Grad gedreht wird, wird sie so skaliert, dass ihre Breite in height passt.


void searchBack()

Verringert den Wert searchModel's current result, so dass die Ansicht zum vorherigen Suchergebnis springt.


void searchForward()

Erhöht den searchModel's current result, so dass die Ansicht zum nächsten Suchergebnis springt.


void selectAll()

Markiert den gesamten Text auf current page und macht ihn auf Systemen, die diese Funktion unterstützen, als selection verfügbar.

Siehe auch copySelectionToClipboard().


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