QPdfWriter Class

Die Klasse QPdfWriter ist eine Klasse zur Erzeugung von PDFs, die als Malgerät verwendet werden können. Mehr...

Kopfzeile: #include <QPdfWriter>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Erbt: 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.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.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

Reimplementierte öffentliche Funktionen

virtual bool newPage() override

Reimplementierte geschützte Funktionen

virtual QPaintEngine *paintEngine() const override

Detaillierte Beschreibung

QPdfWriter erzeugt PDF aus einer Reihe von Zeichenbefehlen mit QPainter. Die Methode newPage() kann verwendet werden, um mehrere Seiten zu erzeugen.

Dokumentation der Mitgliedstypen

[since 6.8] enum class QPdfWriter::ColorModel

Diese Aufzählung beschreibt die Art und Weise, in der die PDF-Engine Strich- und Füllfarben interpretiert, die als QPainter's Stift oder Pinsel (über QPen und QBrush) eingestellt sind.

KonstanteWertBeschreibung
QPdfWriter::ColorModel::RGB0Alle Farben werden in RGB konvertiert und als solche in der PDF-Datei 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 ausgegeben, mit identischen Mengen an Rot, Grün und Blau.
QPdfWriter::ColorModel::CMYK2Alle Farben werden in CMYK konvertiert und als solche gespeichert.
QPdfWriter::ColorModel::Auto3RGB-Farben werden als RGB ausgegeben; CMYK-Farben werden als CMYK ausgegeben. Farben jeder anderen Farbspezifikation werden in RGB konvertiert. Dies ist die Standardeinstellung seit Qt 6.8.

Diese Aufzählung wurde in Qt 6.8 eingeführt.

Siehe auch QColor und QGradient.

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen PDF-Writer, der das PDF nach device schreibt.

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

Konstruiert einen PDF-Writer, der das PDF nach filename schreibt.

[virtual noexcept] QPdfWriter::~QPdfWriter()

Zerstört den PDF-Schreiber.

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

Fügt der PDF-Datei den Anhang fileName mit (optional) mimeType hinzu. data enthält die Rohdaten, die in die PDF-Datei eingebettet werden sollen.

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

Gibt das von diesem PDF-Writer verwendete Farbmodell zurück. Die Vorgabe 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 ist die ID 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 mit einem Aufruf von setDocumentXmpMetadata bereitgestellt wurden. Es werden nicht die Standard-Metadaten zurückgegeben.

Siehe auch setDocumentXmpMetadata().

[override virtual] bool QPdfWriter::newPage()

Reimplements: QPagedPaintDevice::newPage().

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

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

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch setOutputIntent().

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

Reimplements: QPaintDevice::paintEngine() const.

QPagedPaintDevice::PdfVersion QPdfWriter::pdfVersion() const

Gibt die PDF-Version für diesen Writer zurück. Die Vorgabe 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.8] void QPdfWriter::setColorModel(QPdfWriter::ColorModel model)

Setzt das von diesem PDF-Writer verwendete Farbmodell auf model.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch colorModel().

void QPdfWriter::setCreator(const QString &creator)

Setzt den Ersteller des Dokuments auf creator.

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 / setCreator nicht beeinflusst, so dass es dem Benutzer obliegt, sie konsistent zu halten. xmpMetadata enthält XML-formatierte Metadaten, die in die PDF-Datei eingebettet werden.

Siehe auch documentXmpMetadata().

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

Setzt die von diesem PDF-Writer verwendete Ausgabebedingung auf intent.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch outputIntent().

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

Setzt die PDF-Version für diesen Writer auf version.

Wenn version derselbe Wert wie der aktuell eingestellte ist, wird keine Änderung vorgenommen.

Siehe auch pdfVersion().

void QPdfWriter::setResolution(int resolution)

Setzt das PDF resolution in DPI.

Diese Einstellung wirkt sich auf das Koordinatensystem aus, wie es z. B. von QPainter::viewport() zurückgegeben wird.

Siehe auch resolution().

void QPdfWriter::setTitle(const QString &title)

Setzt den Titel des zu erstellenden Dokuments auf title.

Siehe auch title().

QString QPdfWriter::title() const

Gibt den Titel des Dokuments zurück.

Siehe auch setTitle().

© 2025 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.