QPdfWriter Class
La classe QPdfWriter permet de générer des PDF qui peuvent être utilisés comme support de peinture. Plus d'informations...
| En-tête : | #include <QPdfWriter> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite : | QObject et QPagedPaintDevice |
- Liste de tous les membres, y compris les membres hérités
- QPdfWriter fait partie de Painting Classes.
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 en utilisant QPainter. La méthode newPage() peut être utilisée pour créer plusieurs pages.
Documentation des types de membres
[since 6.8] enum class QPdfWriter::ColorModel
Cette énumération décrit la manière dont le moteur PDF interprète les couleurs de tracé et de remplissage, définies comme un stylo ou un pinceau de QPainter(via QPen et QBrush).
| Constante | Valeur | Description |
|---|---|---|
QPdfWriter::ColorModel::RGB | 0 | Toutes les couleurs sont converties en RVB et enregistrées comme telles 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 PDF en tant que 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 comme telles. |
QPdfWriter::ColorModel::Auto | 3 | Les couleurs RVB sont émises en tant que RVB ; les couleurs CMJN sont émises en tant que CMJN. Les couleurs de toute autre spécification de couleur sont converties en RVB. C'est la valeur par défaut depuis Qt 6.8. |
Cette liste a été introduite dans Qt 6.8.
Documentation des fonctions membres
[explicit] QPdfWriter::QPdfWriter(QIODevice *device)
Construit un rédacteur de PDF qui écrira le pdf sur device.
[explicit] QPdfWriter::QPdfWriter(const QString &filename)
Construit un rédacteur de PDF qui écrira le pdf sur filename.
[virtual noexcept] QPdfWriter::~QPdfWriter()
Détruit l'auteur du pdf.
void QPdfWriter::addFileAttachment(const QString &fileName, const QByteArray &data, const QString &mimeType = QString())
Ajoute la pièce jointe fileName au PDF avec (facultatif) mimeType. data contient les données brutes à incorporer 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 rédacteur de PDF. La valeur par défaut est QPdfWriter::ColorModel::Auto.
Cette fonction a été introduite dans Qt 6.8.
Voir aussi setColorModel().
QString QPdfWriter::creator() const
Renvoie le créateur du document.
Voir aussi setCreator().
[since 6.8] QUuid QPdfWriter::documentId() const
Renvoie l'identifiant du document. Par défaut, l'ID est un UUID généré aléatoirement.
Cette fonction a été introduite dans Qt 6.8.
Voir aussi setDocumentId().
QByteArray QPdfWriter::documentXmpMetadata() const
Obtient les métadonnées du document, telles qu'elles ont été fournies lors d'un appel à setDocumentXmpMetadata. Les métadonnées par défaut ne sont pas renvoyées.
Voir aussi 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 rédacteur de PDF.
Cette fonction a été introduite dans Qt 6.8.
Voir aussi setOutputIntent().
[override virtual protected] QPaintEngine *QPdfWriter::paintEngine() const
Réimplémente : QPaintDevice::paintEngine() const.
QPagedPaintDevice::PdfVersion QPdfWriter::pdfVersion() const
Renvoie la version PDF de ce rédacteur. La valeur par défaut est PdfVersion_1_4.
Voir aussi setPdfVersion().
int QPdfWriter::resolution() const
Renvoie la résolution du PDF en DPI.
Voir aussi setResolution().
[since 6.9] void QPdfWriter::setAuthor(const QString &author)
Définit l'auteur du document à 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 rédacteur de PDF à model.
Cette fonction a été introduite dans Qt 6.8.
Voir également colorModel().
void QPdfWriter::setCreator(const QString &creator)
Définit le créateur du document à creator.
Voir aussi creator().
[since 6.8] void QPdfWriter::setDocumentId(QUuid documentId)
Définit l'ID du document à documentId.
Cette fonction a été introduite dans Qt 6.8.
Voir aussi documentId().
void QPdfWriter::setDocumentXmpMetadata(const QByteArray &xmpMetadata)
Définit les métadonnées du document. Ces métadonnées ne sont pas influencées par les méthodes setTitle / setCreator, c'est donc à l'utilisateur de veiller à leur cohérence. xmpMetadata contient des métadonnées au format XML à intégrer dans le fichier PDF.
Voir aussi documentXmpMetadata().
[since 6.8] void QPdfWriter::setOutputIntent(const QPdfOutputIntent &intent)
Définit l'intention de sortie utilisée par ce rédacteur de PDF à 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 rédacteur à version.
Si version est la même valeur que celle actuellement définie, aucune modification ne sera apportée.
Voir également pdfVersion().
void QPdfWriter::setResolution(int resolution)
Définit le PDF resolution en DPI.
Ce paramètre affecte le système de coordonnées tel qu'il est renvoyé, par exemple, par QPainter::viewport().
Voir également resolution().
void QPdfWriter::setTitle(const QString &title)
Définit le titre du document en cours de création à title.
Voir aussi 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.