Sur cette page

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

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

ConstanteValeurDescription
QPdfWriter::ColorModel::RGB0Toutes les couleurs sont converties en RVB et enregistrées sous cette forme 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 fichier PDF sous forme de 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 sous cette forme.
QPdfWriter::ColorModel::Auto3Les 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.

Voir également QColor et QGradient.

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.