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 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPdfWriter ist Teil von Painting Classes.
Ö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.
Konstante | Wert | Beschreibung |
---|---|---|
QPdfWriter::ColorModel::RGB | 0 | Alle Farben werden in RGB konvertiert und als solche in der PDF-Datei 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 ausgegeben, mit identischen Mengen an Rot, Grün und Blau. |
QPdfWriter::ColorModel::CMYK | 2 | Alle Farben werden in CMYK konvertiert und als solche gespeichert. |
QPdfWriter::ColorModel::Auto | 3 | RGB-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.
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.