Auf dieser Seite

QPdfWriter Class

Die Klasse „QPdfWriter“ dient zur Erstellung von PDF-Dateien, die als Zeichenbereich verwendet werden können. Mehr...

Überschrift: #include <QPdfWriter>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Erbt von:QObject und QPagedPaintDevice

Öffentliche Typen

(since 6.8) enum class ColorModel { RGB, Grayscale, CMYK, Auto }

Öffentliche Funktionen

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

Neu implementierte öffentliche Funktionen

virtual bool newPage() override

Neu implementierte geschützte Funktionen

virtual QPaintEngine *paintEngine() const override

Ausführliche Beschreibung

QPdfWriter generiert mithilfe von „ QPainter “ aus einer Reihe von Zeichenbefehlen eine PDF-Datei. Mit der Methode „ newPage()“ können mehrere Seiten erstellt werden.

Dokumentation zu Mitgliedstypen

[since 6.8] enum class QPdfWriter::ColorModel

Diese Aufzählung beschreibt, wie die PDF-Engine die Kontur- und Füllfarben interpretiert, die als Stift oder Pinsel eines „ QPainter “ festgelegt wurden (über QPen und QBrush).

KonstanteWertBeschreibung
QPdfWriter::ColorModel::RGB0Alle Farben werden in RGB umgewandelt und als solche im PDF gespeichert.
QPdfWriter::ColorModel::Grayscale1Alle Farben werden in Graustufen umgewandelt. Aus Gründen der Abwärtskompatibilität werden sie in der PDF-Ausgabe als RGB-Farben mit identischen Anteilen an Rot, Grün und Blau ausgegeben.
QPdfWriter::ColorModel::CMYK2Alle Farben werden in CMYK umgewandelt und als solche gespeichert.
QPdfWriter::ColorModel::Auto3RGB-Farben werden als RGB ausgegeben; CMYK-Farben werden als CMYK ausgegeben. Farben mit einer anderen Farbspezifikation werden in RGB umgewandelt. Dies ist seit Qt 6.8 die Standardeinstellung.

Diese Enumeration wurde in Qt 6.8 eingeführt.

Siehe auch QColor und QGradient.

Dokumentation zu den Mitgliedsfunktionen

[explicit] QPdfWriter::QPdfWriter(QIODevice *device)

Erstellt einen PDF-Writer, der die PDF-Datei unter device speichert.

[explicit] QPdfWriter::QPdfWriter(const QString &filename)

Erstellt einen PDF-Writer, der die PDF-Datei unter filename speichert.

[virtual noexcept] QPdfWriter::~QPdfWriter()

Beendet den PDF-Writer.

void QPdfWriter::addFileAttachment(const QString &fileName, const QByteArray &data, const QString &mimeType = QString())

Fügt dem PDF-Dokument einen Anhang vom Typ „ fileName “ hinzu, gegebenenfalls mit dem Anhang „ mimeType “. Die Datei „ data “ enthält die Rohdaten, die in die PDF-Datei eingebettet werden sollen.

[since 6.9] QString QPdfWriter::author() const

Gibt den Autor des Dokuments zurück.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch ` setAuthor()`.

[since 6.8] QPdfWriter::ColorModel QPdfWriter::colorModel() const

Gibt das von diesem PDF-Writer verwendete Farbmodell zurück. Der Standardwert ist „ QPdfWriter::ColorModel::Auto “.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch ` setColorModel()`.

QString QPdfWriter::creator() const

Gibt den Ersteller des Dokuments zurück.

Siehe auch setCreator().

[since 6.8] QUuid QPdfWriter::documentId() const

Gibt die ID des Dokuments zurück. Standardmäßig handelt es sich bei der ID um eine zufällig generierte UUID.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch ` setDocumentId()`.

QByteArray QPdfWriter::documentXmpMetadata() const

Ruft die Metadaten des Dokuments ab, wie sie bei einem Aufruf von ` setDocumentXmpMetadata` übergeben wurden. Die Standard-Metadaten werden dabei nicht zurückgegeben.

Siehe auch setDocumentXmpMetadata().

[override virtual] bool QPdfWriter::newPage()

Implementiert: QPagedPaintDevice::newPage().

[since 6.8] QPdfOutputIntent QPdfWriter::outputIntent() const

Gibt die von diesem PDF-Writer verwendete Ausgabeabsicht zurück.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch ` setOutputIntent()`.

[override virtual protected] QPaintEngine *QPdfWriter::paintEngine() const

Implementiert erneut: ` QPaintDevice::paintEngine()` const.

QPagedPaintDevice::PdfVersion QPdfWriter::pdfVersion() const

Gibt die PDF-Version für diesen Writer zurück. Der Standardwert ist PdfVersion_1_4.

Siehe auch setPdfVersion().

int QPdfWriter::resolution() const

Gibt die Auflösung der PDF-Datei in DPI zurück.

Siehe auch „ setResolution()“.

[since 6.9] void QPdfWriter::setAuthor(const QString &author)

Legt den Autor des Dokuments auf „ author “ fest.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch author().

[since 6.8] void QPdfWriter::setColorModel(QPdfWriter::ColorModel model)

Legt das von diesem PDF-Writer verwendete Farbmodell auf „ model “ fest.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch ` colorModel()`.

void QPdfWriter::setCreator(const QString &creator)

Legt den Ersteller des Dokuments auf „ creator “ fest.

Siehe auch creator().

[since 6.8] void QPdfWriter::setDocumentId(QUuid documentId)

Setzt die ID des Dokuments auf „ documentId “.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch documentId().

void QPdfWriter::setDocumentXmpMetadata(const QByteArray &xmpMetadata)

Legt die Metadaten des Dokuments fest. Diese Metadaten werden von den Methoden „ setTitle “ und „ setCreator “ nicht beeinflusst, daher ist es Aufgabe des Benutzers, sie konsistent zu halten. „ xmpMetadata “ enthält Metadaten im XML-Format, die in die PDF-Datei eingebettet werden sollen.

Siehe auch documentXmpMetadata().

[since 6.8] void QPdfWriter::setOutputIntent(const QPdfOutputIntent &intent)

Legt die von diesem PDF-Writer verwendete Ausgabeabsicht auf „ intent “ fest.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch ` outputIntent()`.

void QPdfWriter::setPdfVersion(QPagedPaintDevice::PdfVersion version)

Legt die PDF-Version für diesen Writer auf „ version “ fest.

Wenn „ version “ mit dem aktuell eingestellten Wert übereinstimmt, wird keine Änderung vorgenommen.

Siehe auch pdfVersion().

void QPdfWriter::setResolution(int resolution)

Legt die PDF- resolution n in DPI fest.

Diese Einstellung wirkt sich auf das Koordinatensystem aus, wie es beispielsweise von der Funktion ` QPainter::viewport()` zurückgegeben wird.

Siehe auch „ resolution()“.

void QPdfWriter::setTitle(const QString &title)

Legt den Titel des gerade erstellten Dokuments auf „ title “ fest.

Siehe auch title().

QString QPdfWriter::title() const

Gibt den Titel des Dokuments zurück.

Siehe auch „ 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.