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 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPdfWriter ist Teil der Mal-Klassen.
Ö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).
| Konstante | Wert | Beschreibung |
|---|---|---|
QPdfWriter::ColorModel::RGB | 0 | Alle Farben werden in RGB umgewandelt und als solche im PDF gespeichert. |
QPdfWriter::ColorModel::Grayscale | 1 | Alle 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::CMYK | 2 | Alle Farben werden in CMYK umgewandelt und als solche gespeichert. |
QPdfWriter::ColorModel::Auto | 3 | RGB-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.
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.