QPdfWriter Class
La classe QPdfWriter permet de générer des fichiers PDF pouvant servir de périphérique de dessin. En savoir plus...
| En-tête : | #include <QPdfWriter> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite de : | QObject et QPagedPaintDevice |
- Liste de tous les membres, y compris les membres hérités
- QPdfWriter fait partie des classes de dessin.
Types publics
(since 6.8) enum class | ColorModel { RGB, Grayscale, CMYK, Auto } |
Fonctions publiques
| QPdfWriter(QIODevice *device) | |
| QPdfWriter(const QString &filename) | |
| virtual | ~QPdfWriter() |
| void | addFileAttachment(const QString &fileName, const QByteArray &data, const QString &mimeType = QString()) |
(since 6.9) QString | author() const |
(since 6.8) QPdfWriter::ColorModel | colorModel() const |
| QString | creator() const |
(since 6.8) QUuid | documentId() const |
| QByteArray | documentXmpMetadata() const |
(since 6.8) QPdfOutputIntent | outputIntent() const |
| QPagedPaintDevice::PdfVersion | pdfVersion() const |
| int | resolution() const |
(since 6.9) void | setAuthor(const QString &author) |
(since 6.8) void | setColorModel(QPdfWriter::ColorModel model) |
| void | setCreator(const QString &creator) |
(since 6.8) void | setDocumentId(QUuid documentId) |
| void | setDocumentXmpMetadata(const QByteArray &xmpMetadata) |
(since 6.8) void | setOutputIntent(const QPdfOutputIntent &intent) |
| void | setPdfVersion(QPagedPaintDevice::PdfVersion version) |
| void | setResolution(int resolution) |
| void | setTitle(const QString &title) |
| QString | title() const |
Fonctions publiques réimplémentées
| virtual bool | newPage() override |
Fonctions protégées réimplémentées
| virtual QPaintEngine * | paintEngine() const override |
Description détaillée
QPdfWriter génère un fichier PDF à partir d'une série de commandes de dessin à l'aide de QPainter. La méthode newPage() permet de créer plusieurs pages.
Documentation sur les types de membres
[since 6.8] enum class QPdfWriter::ColorModel
Cette liste décrit la manière dont le moteur PDF interprète les couleurs de contour et de remplissage, définies comme stylo ou pinceau d’un « QPainter » (via QPen et QBrush).
| Constante | Valeur | Description |
|---|---|---|
QPdfWriter::ColorModel::RGB | 0 | Toutes les couleurs sont converties en RVB et enregistrées sous cette forme dans le PDF. |
QPdfWriter::ColorModel::Grayscale | 1 | Toutes les couleurs sont converties en niveaux de gris. Pour des raisons de compatibilité ascendante, elles sont émises dans le fichier PDF sous forme de couleurs RVB, avec des quantités identiques de rouge, de vert et de bleu. |
QPdfWriter::ColorModel::CMYK | 2 | Toutes les couleurs sont converties en CMJN et enregistrées sous cette forme. |
QPdfWriter::ColorModel::Auto | 3 | Les couleurs RVB sont générées au format RVB ; les couleurs CMJN sont générées au format CMJN. Les couleurs de tout autre format sont converties en RVB. Il s'agit du comportement par défaut depuis Qt 6.8. |
Cette énumération a été introduite dans Qt 6.8.
Documentation des fonctions membres
[explicit] QPdfWriter::QPdfWriter(QIODevice *device)
Crée un générateur de PDF qui enregistrera le fichier PDF à l'adresse device.
[explicit] QPdfWriter::QPdfWriter(const QString &filename)
Crée un générateur de PDF qui enregistrera le fichier PDF à l'adresse filename.
[virtual noexcept] QPdfWriter::~QPdfWriter()
Supprime le générateur de PDF.
void QPdfWriter::addFileAttachment(const QString &fileName, const QByteArray &data, const QString &mimeType = QString())
Ajoute une pièce jointe au format « fileName » au fichier PDF, avec (facultatif) mimeType. Le fichier data contient les données brutes à intégrer dans le fichier PDF.
[since 6.9] QString QPdfWriter::author() const
Renvoie l'auteur du document.
Cette fonction a été introduite dans Qt 6.9.
Voir aussi setAuthor().
[since 6.8] QPdfWriter::ColorModel QPdfWriter::colorModel() const
Renvoie le modèle de couleur utilisé par ce générateur de PDF. La valeur par défaut est « QPdfWriter::ColorModel::Auto ».
Cette fonction a été introduite dans Qt 6.8.
Voir également setColorModel().
QString QPdfWriter::creator() const
Renvoie l'auteur du document.
Voir aussi setCreator().
[since 6.8] QUuid QPdfWriter::documentId() const
Renvoie l'identifiant du document. Par défaut, cet identifiant est un UUID généré aléatoirement.
Cette fonction a été introduite dans Qt 6.8.
Voir également setDocumentId().
QByteArray QPdfWriter::documentXmpMetadata() const
Récupère les métadonnées du document, telles qu'elles ont été fournies lors d'un appel à la méthode setDocumentXmpMetadata. Cette méthode ne renvoie pas les métadonnées par défaut.
Voir également setDocumentXmpMetadata().
[override virtual] bool QPdfWriter::newPage()
Réimplémente : QPagedPaintDevice::newPage().
[since 6.8] QPdfOutputIntent QPdfWriter::outputIntent() const
Renvoie l'intention de sortie utilisée par ce générateur de PDF.
Cette fonction a été introduite dans Qt 6.8.
Voir également ` setOutputIntent()`.
[override virtual protected] QPaintEngine *QPdfWriter::paintEngine() const
Réimplémente : QPaintDevice::paintEngine() const.
QPagedPaintDevice::PdfVersion QPdfWriter::pdfVersion() const
Renvoie la version PDF pour ce générateur. La valeur par défaut est PdfVersion_1_4.
Voir également setPdfVersion().
int QPdfWriter::resolution() const
Renvoie la résolution du fichier PDF en DPI.
Voir également setResolution().
[since 6.9] void QPdfWriter::setAuthor(const QString &author)
Définit l'auteur du document sur author.
Cette fonction a été introduite dans Qt 6.9.
Voir aussi author().
[since 6.8] void QPdfWriter::setColorModel(QPdfWriter::ColorModel model)
Définit le modèle de couleur utilisé par ce générateur de PDF sur « model ».
Cette fonction a été introduite dans Qt 6.8.
Voir également colorModel().
void QPdfWriter::setCreator(const QString &creator)
Définit « creator » comme auteur du document.
Voir aussi creator().
[since 6.8] void QPdfWriter::setDocumentId(QUuid documentId)
Définit l'identifiant du document sur documentId.
Cette fonction a été introduite dans Qt 6.8.
Voir également documentId().
void QPdfWriter::setDocumentXmpMetadata(const QByteArray &xmpMetadata)
Définit les métadonnées du document. Ces métadonnées ne sont pas modifiées par les méthodes setTitle / setCreator; il appartient donc à l'utilisateur de veiller à leur cohérence. Le fichier xmpMetadata contient des métadonnées au format XML à intégrer dans le fichier PDF.
Voir également documentXmpMetadata().
[since 6.8] void QPdfWriter::setOutputIntent(const QPdfOutputIntent &intent)
Définit l'intention de sortie utilisée par ce générateur de PDF sur « intent ».
Cette fonction a été introduite dans Qt 6.8.
Voir également outputIntent().
void QPdfWriter::setPdfVersion(QPagedPaintDevice::PdfVersion version)
Définit la version PDF de ce générateur sur « version ».
Si la valeur de ` version ` est identique à celle actuellement définie, aucune modification n'est effectuée.
Voir également pdfVersion().
void QPdfWriter::setResolution(int resolution)
Définit l'resolution du PDF en DPI.
Ce paramètre affecte le système de coordonnées tel qu'il est renvoyé, par exemple, par la fonction ` QPainter::viewport()`.
Voir également resolution().
void QPdfWriter::setTitle(const QString &title)
Définit le titre du document en cours de création sur « title ».
Voir également title().
QString QPdfWriter::title() const
Renvoie le titre du document.
Voir aussi setTitle().
© 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.