En esta página

QPdfWriter Class

La clase QPdfWriter es una clase que permite generar archivos PDF y que puede utilizarse como dispositivo de dibujo. Más información...

Encabezado: #include <QPdfWriter>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de:QObject y QPagedPaintDevice

Tipos públicos

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

Funciones públicas

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

Funciones públicas reimplementadas

virtual bool newPage() override

Funciones protegidas reimplementadas

virtual QPaintEngine *paintEngine() const override

Descripción detallada

QPdfWriter genera un archivo PDF a partir de una serie de comandos de dibujo utilizando QPainter. El método newPage() se puede utilizar para crear varias páginas.

Documentación sobre los tipos de miembros

[since 6.8] enum class QPdfWriter::ColorModel

Esta enumeración describe la forma en que el motor PDF interpreta los colores de trazo y relleno, configurados como pluma o pincel de un « QPainter » (a través de QPen y QBrush).

ConstanteValorDescripción
QPdfWriter::ColorModel::RGB0Todos los colores se convierten a RGB y se guardan como tales en el PDF.
QPdfWriter::ColorModel::Grayscale1Todos los colores se convierten a escala de grises. Por motivos de compatibilidad con versiones anteriores, se emiten en la salida PDF como colores RGB, con cantidades idénticas de rojo, verde y azul.
QPdfWriter::ColorModel::CMYK2Todos los colores se convierten a CMYK y se guardan como tales.
QPdfWriter::ColorModel::Auto3Los colores RGB se emiten como RGB; los colores CMYK se emiten como CMYK. Los colores de cualquier otro formato se convierten a RGB. Esta es la configuración predeterminada desde Qt 6.8.

Esta enumeración se introdujo en Qt 6.8.

Véase también QColor y QGradient.

Documentación de las funciones miembro

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

Crea un generador de PDF que guardará el archivo PDF en device.

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

Crea un generador de PDF que guardará el archivo PDF en filename.

[virtual noexcept] QPdfWriter::~QPdfWriter()

Elimina el generador de PDF.

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

Añade un archivo adjunto de tipo « fileName » al PDF con (opcional) mimeType. data contiene los datos sin procesar del archivo que se van a incrustar en el archivo PDF.

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

Devuelve el autor del documento.

Esta función se introdujo en Qt 6.9.

Véase también setAuthor().

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

Devuelve el modelo de color utilizado por este generador de PDF. El valor por defecto es « QPdfWriter::ColorModel::Auto ».

Esta función se introdujo en Qt 6.8.

Véase también setColorModel().

QString QPdfWriter::creator() const

Devuelve el creador del documento.

Véase también setCreator().

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

Devuelve el ID del documento. Por defecto, el ID es un UUID generado aleatoriamente.

Esta función se introdujo en Qt 6.8.

Véase también ` setDocumentId()`.

QByteArray QPdfWriter::documentXmpMetadata() const

Obtiene los metadatos del documento, tal y como se proporcionaron mediante una llamada a setDocumentXmpMetadata. No devolverá los metadatos predeterminados.

Véase también setDocumentXmpMetadata().

[override virtual] bool QPdfWriter::newPage()

Reimplementa: QPagedPaintDevice::newPage().

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

Devuelve la intención de salida utilizada por este generador de PDF.

Esta función se introdujo en Qt 6.8.

Véase también setOutputIntent().

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

Reimplementa: ` QPaintDevice::paintEngine()` const.

QPagedPaintDevice::PdfVersion QPdfWriter::pdfVersion() const

Devuelve la versión en PDF para este escritor. El valor por defecto es PdfVersion_1_4.

Véase también setPdfVersion().

int QPdfWriter::resolution() const

Devuelve la resolución del PDF en DPI.

Véase también setResolution().

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

Establece el autor del documento como author.

Esta función se introdujo en Qt 6.9.

Véase también author().

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

Establece el modelo de color utilizado por este generador de PDF en « model ».

Esta función se introdujo en Qt 6.8.

Véase también colorModel().

void QPdfWriter::setCreator(const QString &creator)

Establece el autor del documento como creator.

Véase también creator().

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

Establece el ID del documento en « documentId ».

Esta función se introdujo en Qt 6.8.

Véase también documentId().

void QPdfWriter::setDocumentXmpMetadata(const QByteArray &xmpMetadata)

Establece los metadatos del documento. Estos metadatos no se ven afectados por los métodos setTitle / setCreator, por lo que es responsabilidad del usuario mantener su coherencia. xmpMetadata contiene metadatos en formato XML para incrustar en el archivo PDF.

Véase también documentXmpMetadata().

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

Establece la intención de salida que utiliza este generador de PDF en « intent ».

Esta función se introdujo en Qt 6.8.

Véase también outputIntent().

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

Establece la versión de PDF para este generador en « version ».

Si version tiene el mismo valor que el establecido actualmente, no se realizará ningún cambio.

Véase también pdfVersion().

void QPdfWriter::setResolution(int resolution)

Establece el « resolution » del PDF en DPI.

Esta configuración afecta al sistema de coordenadas devuelto, por ejemplo, por la función ` QPainter::viewport()`.

Véase también resolution().

void QPdfWriter::setTitle(const QString &title)

Establece el título del documento que se está creando como « title ».

Véase también title().

QString QPdfWriter::title() const

Devuelve el título del documento.

Véase también 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.