Sur cette page

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

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).

ConstanteValeurDescription
QPdfWriter::ColorModel::RGB0Toutes les couleurs sont converties en RVB et enregistrées comme telles dans le PDF.
QPdfWriter::ColorModel::Grayscale1Toutes 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::CMYK2Toutes les couleurs sont converties en CMJN et enregistrées comme telles.
QPdfWriter::ColorModel::Auto3Les 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.

Voir aussi QColor et QGradient.

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.