Qt PDF

Le module Qt PDF contient des classes et des fonctions pour le rendu de documents PDF. La classe QPdfDocument charge un document PDF et en restitue les pages selon les options fournies par la classe QPdfDocumentRenderOptions. La classe QPdfPageRenderer gère une file d'attente qui recueille toutes les demandes de rendu. La classe QPdfPageNavigator gère la navigation dans un document PDF. La classe QPdfSearchModel recherche une chaîne de caractères et conserve les résultats de la recherche. La classe QPdfBookmarkModel contient la table des matières, le cas échéant. La classe QPdfLinkModel contient des informations sur les hyperliens d'une page. Le widget QPdfView est une visionneuse PDF complète, et l'exemple de widget de visionneuse PDF montre comment l'utiliser.

Pour les applications Qt Quick, trois types de composants de visualisation complets sont fournis. PdfMultiPageView devrait être votre premier choix pour l'expérience utilisateur la plus courante : parcourir les pages du document entier. PdfScrollablePageView affiche une page à la fois, avec défilement ; et PdfPageView affiche une page complète à la fois, sans défilement.

Les composants de visualisation complets sont composés de composants QML de niveau inférieur qui peuvent être utilisés séparément si vous avez besoin d'écrire une application de visualisation de PDF plus personnalisée : PdfDocument, PdfPageImage, PdfPageNavigator, PdfSelection, PdfSearchModel, PdfLinkModel, et PdfBookmarkModel.

Si vous n'avez besoin que de rendre des images de page, sans fonctionnalités telles que la sélection de texte, la recherche et la navigation, ce module comprend un plugin QImageIOHandler qui traite le PDF comme un format d'image modulable, similaire au SVG. Vous pouvez simplement utiliser Image et définir la propriété currentFrame avec l'index de la page que vous souhaitez afficher. Si le fichier PDF ne rend pas son propre arrière-plan, l'image a un arrière-plan transparent.

Utilisation du module

L'utilisation d'un module Qt nécessite l'établissement d'un lien avec la bibliothèque du module, soit directement, soit par l'intermédiaire d'autres dépendances. Plusieurs outils de construction disposent d'un support dédié à cet effet, notamment CMake et qmake.

Construction avec CMake

Utilisez la commande find_package() pour localiser les composants du module nécessaires dans le paquet Qt6:

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

Voir aussi l'aperçu de la construction avec CMake.

Construction avec qmake

Pour établir un lien avec le module, ajoutez cette ligne à votre fichier de projet qmake :

QT += pdf

Exemples

• Qt PDF Exemples

Référence API

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

Articles et guides

• Notes sur la plate-forme

Licences et attributions

Qt PDF est disponible sous les licences commerciales de The Qt Company. En outre, il est disponible sous la licence GNU Lesser General Public License, version 3, ou la licence GNU General Public License, version 2. Voir Qt PDF Licences pour plus de détails sur ce module.