En esta página

QPagedPaintDevice Class

La clase `QPagedPaintDevice` representa un dispositivo de dibujo que admite varias páginas. Más información...

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

QPdfWriter y QPrinter

Tipos públicos

enum PdfVersion { PdfVersion_1_4, PdfVersion_A1b, PdfVersion_1_6, PdfVersion_X4 }

Funciones públicas

virtual ~QPagedPaintDevice()
virtual bool newPage() = 0
QPageLayout pageLayout() const
(since 6.0) QPageRanges pageRanges() const
virtual bool setPageLayout(const QPageLayout &newPageLayout)
virtual bool setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter)
virtual bool setPageOrientation(QPageLayout::Orientation orientation)
(since 6.0) virtual void setPageRanges(const QPageRanges &ranges)
virtual bool setPageSize(const QPageSize &pageSize)

Descripción detallada

Los dispositivos de pintura paginados se utilizan para generar resultados para impresión o para formatos como PDF. QPdfWriter y QPrinter heredan de él.

Documentación de los tipos de miembro

enum QPagedPaintDevice::PdfVersion

La enumeración `PdfVersion` describe la versión del archivo PDF generado por QPrinter o QPdfWriter.

ConstanteValorDescripción
QPagedPaintDevice::PdfVersion_1_40Se genera un documento compatible con PDF 1.4.
QPagedPaintDevice::PdfVersion_A1b1Se genera un documento compatible con PDF/A-1b.
QPagedPaintDevice::PdfVersion_1_62Se genera un documento compatible con PDF 1.6. Este valor se añadió en Qt 5.12.
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8)3Se genera un documento compatible con PDF/X-4.

Documentación de las funciones miembro

[virtual noexcept] QPagedPaintDevice::~QPagedPaintDevice()

Destruye el objeto.

[pure virtual] bool QPagedPaintDevice::newPage()

Abre una nueva página. Devuelve « true » si se realiza correctamente.

QPageLayout QPagedPaintDevice::pageLayout() const

Devuelve el diseño de la página actual. Utiliza este método para acceder a los métodos actuales QPageSize, QPageLayout::Orientation, QMarginsF, fullRect() y paintRect().

Ten en cuenta que no puedes utilizar los métodos de configuración del objeto devuelto; debes llamar a los métodos de configuración individuales de ` QPagedPaintDevice ` o utilizar ` setPageLayout()`.

Véanse también setPageLayout(), setPageSize(), setPageOrientation() y setPageMargins().

[since 6.0] QPageRanges QPagedPaintDevice::pageRanges() const

Devuelve los rangos de páginas asociados a este dispositivo.

Esta función se introdujo en Qt 6.0.

Véase también setPageRanges(), QPageRanges, QPrinter::fromPage() y QPrinter::toPage().

[virtual] bool QPagedPaintDevice::setPageLayout(const QPageLayout &newPageLayout)

Establece el diseño de la página en « newPageLayout ».

Debes llamar a este método antes de llamar a ` QPainter::begin()` o inmediatamente antes de llamar a ` newPage()` para aplicar el nuevo diseño de página a una página nueva. No debes llamar a ningún método de dibujo entre la llamada a `setPageLayout()` y ` newPage()`, ya que podrían utilizarse métricas de dibujo incorrectas.

Devuelve «true» si el diseño de la página se ha establecido correctamente en ` newPageLayout`.

Véase también pageLayout().

[virtual] bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter)

Establece la página margins definida en el archivo units.

Debes llamar a este método antes de llamar a ` QPainter::begin()` o inmediatamente antes de llamar a ` newPage()` para aplicar los nuevos márgenes a una nueva página. No debes llamar a ningún método de dibujo entre la llamada a `setPageMargins()` y ` newPage()`, ya que podrían utilizarse métricas de dibujo incorrectas.

Para obtener los márgenes actuales de la página, utilice ` pageLayout()`. `margins()`.

Devuelve «true» si los márgenes de la página se han establecido correctamente en margins.

Véase también pageLayout().

[virtual] bool QPagedPaintDevice::setPageOrientation(QPageLayout::Orientation orientation)

Establece la orientación de la página orientation.

La orientación de la página se utiliza para definir la orientación del tamaño de la página al obtener el rectángulo de la página.

Debes llamar a este método antes de llamar a ` QPainter::begin()` o inmediatamente antes de llamar a ` newPage()` para aplicar la nueva orientación a una página nueva. No debes llamar a ningún método de dibujo entre la llamada a `setPageOrientation()` y ` newPage()`, ya que podrían utilizarse métricas de dibujo incorrectas.

QPageLayout::Orientation Para obtener la orientación actual de la página, utilice ` pageLayout()`.orientation().

Devuelve «true» si la orientación de la página se ha establecido correctamente en « orientation ».

Véase también pageLayout().

[virtual, since 6.0] void QPagedPaintDevice::setPageRanges(const QPageRanges &ranges)

Establece los rangos de páginas de este dispositivo en ranges.

Esta función se introdujo en Qt 6.0.

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

[virtual] bool QPagedPaintDevice::setPageSize(const QPageSize &pageSize)

Establece el tamaño de la página en pageSize.

Para obtener el tamaño de página actual de « QPageSize », utiliza « pageLayout()».pageSize().

Debes llamar a este método antes de llamar a ` QPainter::begin()` o inmediatamente antes de llamar a ` newPage()` para aplicar el nuevo tamaño de página a una página nueva. No debes llamar a ningún método de dibujo entre la llamada a `setPageSize()` y la de ` newPage()`, ya que podrían utilizarse métricas de dibujo incorrectas.

Devuelve true si el tamaño de la página se ha establecido correctamente en pageSize.

Véase también pageLayout().

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