Qt PDF

Das Modul Qt PDF enthält Klassen und Funktionen zum Rendern von PDF-Dokumenten. Die Klasse QPdfDocument lädt ein PDF-Dokument und rendert die Seiten daraus entsprechend den von der Klasse QPdfDocumentRenderOptions bereitgestellten Optionen. Die Klasse QPdfPageRenderer verwaltet eine Warteschlange, die alle Rendering-Anforderungen sammelt. Die Klasse QPdfPageNavigator kümmert sich um die Navigation durch ein PDF-Dokument. Die Klasse QPdfSearchModel sucht nach einer Zeichenkette und speichert die Suchergebnisse. Die Klasse QPdfBookmarkModel enthält das Inhaltsverzeichnis, falls vorhanden. Die Klasse QPdfLinkModel enthält Informationen über Hyperlinks auf einer Seite. Das QPdfView Widget ist ein vollständiger PDF-Viewer, und das PDF Viewer Widget-Beispiel zeigt, wie man es verwendet.

Für Qt Quick -Anwendungen werden drei Arten von Viewer-Komponenten mit vollem Funktionsumfang bereitgestellt. PdfMultiPageView sollte Ihre erste Wahl für die gängigste Benutzererfahrung sein: das Blättern durch die Seiten des gesamten Dokuments. PdfScrollablePageView zeigt eine Seite nach der anderen mit Scrollen an; und PdfPageView zeigt eine ganze Seite nach der anderen ohne Scrollen an.

Die voll funktionsfähigen Viewer-Komponenten bestehen aus QML-Komponenten auf niedrigerer Ebene, die separat verwendet werden können, wenn Sie eine individuellere PDF-Anzeigeanwendung schreiben möchten: PdfDocument, PdfPageImage, PdfPageNavigator, PdfSelection, PdfSearchModel, PdfLinkModel, und PdfBookmarkModel.

Wenn Sie nur Seitenbilder rendern müssen, ohne Funktionen wie Textauswahl, Suche und Navigation, enthält dieses Modul ein QImageIOHandler Plugin, das PDF als skalierbares Bildformat behandelt, ähnlich wie SVG. Sie können einfach Image verwenden und die Eigenschaft currentFrame auf den Seitenindex setzen, den Sie anzeigen möchten. Wenn die PDF-Datei keinen eigenen Hintergrund rendert, hat das Bild einen transparenten Hintergrund.

Verwendung des Moduls

Die Verwendung eines Qt-Moduls erfordert eine Verknüpfung mit der Modulbibliothek, entweder direkt oder über andere Abhängigkeiten. Mehrere Build-Tools bieten hierfür spezielle Unterstützung, darunter CMake und qmake.

Bauen mit CMake

Verwenden Sie den Befehl find_package(), um die benötigten Modulkomponenten im Paket Qt6 zu finden:

find_package(Qt6 REQUIRED COMPONENTS Pdf)
target_link_libraries(mytarget Qt6::Pdf)

Siehe auch die Übersicht Bauen mit CMake.

Bauen mit qmake

Um gegen das Modul zu linken, fügen Sie diese Zeile zu Ihrer qmake-Projektdatei hinzu:

QT += pdf

Beispiele

• Qt PDF Beispiele

API-Referenz

• Qt PDF C++ Classes
• Qt Quick PDF QML Types

Artikel und Anleitungen

• {Qt PDF Plattform-Hinweise} {Plattform-Hinweise}

Lizenzen und Namensnennung

Qt PDF ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter der GNU Lesser General Public License, Version 3, oder der GNU General Public License, Version 2, erhältlich. Weitere Informationen zu diesem Modul finden Sie unter Qt PDF Licensing.