QPdfPageRenderer Class
La classe QPdfPageRenderer encapsule le rendu des pages d'un document PDF. Plus d'informations...
| Header: | #include <QPdfPageRenderer> |
| Inherits: | QObject |
Types publics
| enum class | RenderMode { MultiThreaded, SingleThreaded } |
Propriétés
- document : QPdfDocument*
- renderMode : RenderMode
Fonctions publiques
| QPdfPageRenderer(QObject *parent) | |
| virtual | ~QPdfPageRenderer() override |
| QPdfDocument * | document() const |
| QPdfPageRenderer::RenderMode | renderMode() const |
| quint64 | requestPage(int pageNumber, QSize imageSize, QPdfDocumentRenderOptions options = QPdfDocumentRenderOptions()) |
| void | setDocument(QPdfDocument *document) |
| void | setRenderMode(QPdfPageRenderer::RenderMode mode) |
Signaux
| void | documentChanged(QPdfDocument *document) |
| void | renderModeChanged(QPdfPageRenderer::RenderMode renderMode) |
Description détaillée
Le QPdfPageRenderer contient une file d'attente qui recueille toutes les demandes de rendu invoquées par l'intermédiaire de requestPage(). En fonction de la configuration de RenderMode, le QPdfPageRenderer traite cette file d'attente dans le thread principal de l'interface utilisateur lors de la prochaine invocation de la boucle d'événement (RenderMode::SingleThreaded) ou dans un thread de travail séparé (RenderMode::MultiThreaded) et émet le résultat via le signal pageRendered() pour chaque demande une fois que le rendu est effectué.
Voir également QPdfDocument.
Documentation sur les types de membres
enum class QPdfPageRenderer::RenderMode
Cette énumération décrit la manière dont les pages sont rendues.
| Constante | Valeur | Description |
|---|---|---|
QPdfPageRenderer::RenderMode::MultiThreaded | 0 | Toutes les pages sont rendues dans un fil d'exécution distinct. |
QPdfPageRenderer::RenderMode::SingleThreaded | 1 | Toutes les pages sont rendues dans le thread principal de l'interface utilisateur (par défaut). |
Voir également renderMode() et setRenderMode().
Propriété Documentation
document : QPdfDocument*
Cette propriété contient l'instance de document à partir de laquelle cet objet rend les pages.
Par défaut, cette propriété est nullptr.
Fonctions d'accès :
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
Notifier signal :
| void | documentChanged(QPdfDocument *document) |
Voir également document(), setDocument() et QPdfDocument.
renderMode : RenderMode
Cette propriété indique le mode utilisé par le moteur de rendu pour rendre les pages.
Par défaut, cette propriété est RenderMode::SingleThreaded.
Fonctions d'accès :
| QPdfPageRenderer::RenderMode | renderMode() const |
| void | setRenderMode(QPdfPageRenderer::RenderMode mode) |
Notifier signal :
| void | renderModeChanged(QPdfPageRenderer::RenderMode renderMode) |
Voir également setRenderMode() et RenderMode.
Documentation des fonctions membres
[explicit] QPdfPageRenderer::QPdfPageRenderer(QObject *parent)
Construit un objet de rendu de page avec l'objet parent parent.
[override virtual noexcept] QPdfPageRenderer::~QPdfPageRenderer()
Détruit l'objet de rendu de page.
QPdfDocument *QPdfPageRenderer::document() const
Renvoie le document à partir duquel cet objet effectue le rendu des pages, ou une adresse nullptr si aucun document n'a été défini auparavant.
Note : Fonction Getter pour la propriété document.
Voir aussi setDocument() et QPdfDocument.
QPdfPageRenderer::RenderMode QPdfPageRenderer::renderMode() const
Renvoie le mode de rendu des pages.
Remarque : fonction Getter pour la propriété renderMode.
Voir aussi setRenderMode() et RenderMode.
quint64 QPdfPageRenderer::requestPage(int pageNumber, QSize imageSize, QPdfDocumentRenderOptions options = QPdfDocumentRenderOptions())
Demande au moteur de rendu de rendre la page pageNumber en une page QImage de taille imageSize conformément à la page options fournie.
Une fois le rendu effectué, le signal pageRendered() est émis avec le résultat comme paramètre.
La valeur de retour est un ID qui identifie de manière unique la demande de rendu. Si une demande avec les mêmes paramètres est encore dans la file d'attente, l'ID de cette demande est renvoyée.
void QPdfPageRenderer::setDocument(QPdfDocument *document)
Définit le site document à partir duquel cet objet rend les pages.
Remarque : fonction de définition de la propriété document.
Voir aussi document() et QPdfDocument.
void QPdfPageRenderer::setRenderMode(QPdfPageRenderer::RenderMode mode)
Définit le mode de rendu des pages sur mode.
Remarque : fonction de définition de la propriété renderMode.
Voir aussi renderMode() et RenderMode.
© 2026 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.
