QPageLayout Class
Describe el tamaño, la orientación y los márgenes de una página. Más...
| Cabecera: | #include <QPageLayout> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
Tipos Públicos
| enum | Mode { StandardMode, FullPageMode } |
| enum | Orientation { Portrait, Landscape } |
(since 6.8) enum class | OutOfBoundsPolicy { Reject, Clamp } |
| enum | Unit { Millimeter, Point, Inch, Pica, Didot, Cicero } |
Funciones públicas
| QPageLayout() | |
| QPageLayout(const QPageSize &pageSize, QPageLayout::Orientation orientation, const QMarginsF &margins, QPageLayout::Unit units = Point, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0)) | |
| QPageLayout(const QPageLayout &other) | |
| ~QPageLayout() | |
| QRectF | fullRect() const |
| QRectF | fullRect(QPageLayout::Unit units) const |
| QRect | fullRectPixels(int resolution) const |
| QRect | fullRectPoints() const |
| bool | isEquivalentTo(const QPageLayout &other) const |
| bool | isValid() const |
| QMarginsF | margins() const |
| QMarginsF | margins(QPageLayout::Unit units) const |
| QMargins | marginsPixels(int resolution) const |
| QMargins | marginsPoints() const |
| QMarginsF | maximumMargins() const |
| QMarginsF | minimumMargins() const |
| QPageLayout::Mode | mode() const |
| QPageLayout::Orientation | orientation() const |
| QPageSize | pageSize() const |
| QRectF | paintRect() const |
| QRectF | paintRect(QPageLayout::Unit units) const |
| QRect | paintRectPixels(int resolution) const |
| QRect | paintRectPoints() const |
| bool | setBottomMargin(qreal bottomMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| bool | setLeftMargin(qreal leftMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| bool | setMargins(const QMarginsF &margins, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| void | setMinimumMargins(const QMarginsF &minMargins) |
| void | setMode(QPageLayout::Mode mode) |
| void | setOrientation(QPageLayout::Orientation orientation) |
| void | setPageSize(const QPageSize &pageSize, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0)) |
| bool | setRightMargin(qreal rightMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| bool | setTopMargin(qreal topMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| void | setUnits(QPageLayout::Unit units) |
| void | swap(QPageLayout &other) |
| QPageLayout::Unit | units() const |
| QPageLayout & | operator=(QPageLayout &&other) |
| QPageLayout & | operator=(const QPageLayout &other) |
No miembros relacionados
| bool | operator!=(const QPageLayout &lhs, const QPageLayout &rhs) |
| bool | operator==(const QPageLayout &lhs, const QPageLayout &rhs) |
Descripción Detallada
La clase QPageLayout define el diseño de una página en un documento paginado, con el tamaño de página, la orientación y los márgenes que se pueden establecer y los rectángulos de página completa y de página pintable definidos por esos atributos que se pueden consultar en una variedad de unidades.
El tamaño de página se define mediante la clase QPageSize, a la que se pueden consultar los atributos de tamaño de página. Tenga en cuenta que la propia QPageSize siempre se define en orientación vertical.
Los márgenes mínimos pueden definirse para el diseño, pero normalmente son 0. Cuando se utiliza junto con el soporte de impresión de Qt, los márgenes mínimos reflejarán el área mínima imprimible definida por la impresora.
En StandardMode por defecto siempre se tienen en cuenta los márgenes actuales y los márgenes mínimos. El rectángulo pintable es el rectángulo de la página completa menos los márgenes actuales, y los márgenes actuales sólo pueden establecerse a valores entre los márgenes mínimos y los márgenes máximos permitidos por el tamaño de la página completa.
En FullPageMode no se tienen en cuenta los márgenes actuales ni los márgenes mínimos. El rectángulo pintable es el rectángulo de página completa, y los márgenes actuales pueden establecerse en cualquier valor independientemente de los márgenes mínimos y del tamaño de página.
Véase también QPageSize.
Documentación de tipos de miembros
enum QPageLayout::Mode
Define el modo de diseño de la página
| Constante | Valor | Descripción |
|---|---|---|
QPageLayout::StandardMode | 0 | Paint Rect incluye márgenes, los márgenes deben estar entre el mínimo y el máximo. |
QPageLayout::FullPageMode | 1 | Paint Rect excluye márgenes, los márgenes pueden ser de cualquier valor y deben gestionarse manualmente. |
En el Modo Estándar, cuando establezca los márgenes, utilice Clamp para ajustar automáticamente los márgenes entre los valores mínimo y máximo permitidos.
Véase también OutOfBoundsPolicy.
enum QPageLayout::Orientation
Este tipo enum define la orientación de la página
| Constante | Valor | Descripción |
|---|---|---|
QPageLayout::Portrait | 0 | El tamaño de página se utiliza en su orientación por defecto |
QPageLayout::Landscape | 1 | El tamaño de página se gira 90 grados |
Tenga en cuenta que algunos tamaños de página estándar se definen con una anchura mayor que su altura, por lo que la orientación se define en relación con el tamaño de página estándar y no utilizando las dimensiones relativas de la página.
[since 6.8] enum class QPageLayout::OutOfBoundsPolicy
Define la política para los márgenes que están fuera de los límites
| Constante | Valor | Descripción |
|---|---|---|
QPageLayout::OutOfBoundsPolicy::Reject | 0 | Los márgenes deben estar dentro de los valores mínimo y máximo, de lo contrario serán rechazados. |
QPageLayout::OutOfBoundsPolicy::Clamp | 1 | Los márgenes se fijan entre los valores mínimo y máximo para garantizar su validez. |
Nota: La política no tiene efecto en FullPageMode, donde se aceptan todos los márgenes.
Este enum se introdujo en Qt 6.8.
enum QPageLayout::Unit
Este tipo enum se utiliza para especificar la unidad de medida para el diseño de página y los márgenes.
| Constante | Valor | Descripción |
|---|---|---|
QPageLayout::Millimeter | 0 | |
QPageLayout::Point | 1 | 1/72 de pulgada |
QPageLayout::Inch | 2 | |
QPageLayout::Pica | 3 | 1/72 de pie, 1/6 de pulgada, 12 Puntos |
QPageLayout::Didot | 4 | 1/72 de pulgada francesa, 0,375 mm |
QPageLayout::Cicero | 5 | 1/6 de pulgada francesa, 12 Didot, 4,5 mm |
Documentación de la función de miembro
QPageLayout::QPageLayout()
Crea un QPageLayout inválido.
QPageLayout::QPageLayout(const QPageSize &pageSize, QPageLayout::Orientation orientation, const QMarginsF &margins, QPageLayout::Unit units = Point, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0))
Crea un QPageLayout con los campos pageSize, orientation y margins en el campo units.
Opcionalmente define los márgenes mínimos permitidos minMargins, por ejemplo, los márgenes mínimos capaces de ser impresos por un dispositivo físico de impresión.
El QPageLayout construido estará en StandardMode.
El margins dado se ajustará a los márgenes mínimos y máximos permitidos por el tamaño de página.
QPageLayout::QPageLayout(const QPageLayout &other)
Constructor de copia, copia other a esto.
[noexcept] QPageLayout::~QPageLayout()
Destruye el diseño de la página.
QRectF QPageLayout::fullRect() const
Devuelve el rectángulo de página completo en las unidades de diseño actuales.
El rectángulo de página tiene en cuenta el tamaño y la orientación de la página, pero no los márgenes.
Véase también paintRect() y units().
QRectF QPageLayout::fullRect(QPageLayout::Unit units) const
Devuelve el rectángulo de página completo en la dirección units.
El rectángulo de página tiene en cuenta el tamaño y la orientación de la página, pero no sus márgenes.
Véase también paintRect().
QRect QPageLayout::fullRectPixels(int resolution) const
Devuelve el rectángulo de página completa en píxeles de dispositivo para el resolution dado .
El rectángulo de página tiene en cuenta el tamaño y la orientación de la página, pero no los márgenes.
Véase también paintRect().
QRect QPageLayout::fullRectPoints() const
Devuelve el rectángulo de la página completa en puntos Postscript (1/72 de pulgada).
El rectángulo de página tiene en cuenta el tamaño y la orientación de la página, pero no sus márgenes.
Véase también paintRect().
bool QPageLayout::isEquivalentTo(const QPageLayout &other) const
Devuelve true si este diseño de página es equivalente al diseño de página other, es decir, si la página tiene el mismo tamaño, márgenes y orientación.
bool QPageLayout::isValid() const
Devuelve true si este diseño de página es válido.
QMarginsF QPageLayout::margins() const
Devuelve los márgenes del diseño de página utilizando las unidades configuradas actualmente.
Véase también setMargins() y units().
QMarginsF QPageLayout::margins(QPageLayout::Unit units) const
Devuelve los márgenes del diseño de página utilizando la dirección units solicitada.
Véase también setMargins() y margins().
QMargins QPageLayout::marginsPixels(int resolution) const
Devuelve los márgenes del diseño de página en píxeles de dispositivo para el resolution dado.
Véase también setMargins().
QMargins QPageLayout::marginsPoints() const
Devuelve los márgenes del diseño de página en puntos Postscript (1/72 de pulgada).
Véase también setMargins() y margins().
QMarginsF QPageLayout::maximumMargins() const
Devuelve los márgenes máximos que se aplicarían si el diseño de página estuviera en StandardMode.
Los márgenes máximos permitidos se calculan como el tamaño completo de la página menos los márgenes mínimos establecidos. Por ejemplo, si el ancho de la página es de 100 puntos y el margen derecho mínimo es de 10 puntos, el margen izquierdo máximo será de 90 puntos.
Véase también setMinimumMargins() y minimumMargins().
QMarginsF QPageLayout::minimumMargins() const
Devuelve los márgenes mínimos del diseño de página.
Véase también setMinimumMargins() y maximumMargins().
QPageLayout::Mode QPageLayout::mode() const
Devuelve el modo de diseño de la página.
Véase también setMode().
QPageLayout::Orientation QPageLayout::orientation() const
Devuelve la orientación de la página del diseño de página.
Véase también setOrientation().
QPageSize QPageLayout::pageSize() const
Devuelve el tamaño de página del diseño de página.
Tenga en cuenta que QPageSize siempre se define en orientación Vertical. Para obtener un tamaño que tenga en cuenta la orientación definida debe utilizar fullRect().
Véase también setPageSize().
QRectF QPageLayout::paintRect() const
Devuelve el rectángulo de la página en las unidades de diseño actuales.
El rectángulo pintable tiene en cuenta el tamaño de página, la orientación y los márgenes.
Si se establece el modo FullPageMode, se devuelve fullRect() y los márgenes deben gestionarse manualmente.
QRectF QPageLayout::paintRect(QPageLayout::Unit units) const
Devuelve el rectángulo de la página en la dirección units requerida.
El rectángulo pintable tiene en cuenta el tamaño de la página, la orientación y los márgenes.
Si el modo FullPageMode está configurado, se devuelve fullRect() y los márgenes deben gestionarse manualmente.
QRect QPageLayout::paintRectPixels(int resolution) const
Devuelve el rectángulo pintable en píxeles de dispositivo redondeados para el resolution dado .
El rectángulo pintable tiene en cuenta el tamaño de la página, la orientación y los márgenes.
Si se establece el modo FullPageMode, se devuelve fullRect() y los márgenes deben gestionarse manualmente.
QRect QPageLayout::paintRectPoints() const
Devuelve el rectángulo pintable en Puntos Postscript redondeados (1/72 de pulgada).
El rectángulo pintable tiene en cuenta el tamaño de la página, la orientación y los márgenes.
Si se establece el modo FullPageMode, se devuelve fullRect() y los márgenes deben gestionarse manualmente.
bool QPageLayout::setBottomMargin(qreal bottomMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
Establece el margen inferior de la página en bottomMargin. Devuelve verdadero si el margen se ha establecido correctamente.
Las unidades utilizadas son las definidas actualmente para el diseño. Para utilizar unidades diferentes, llame primero a setUnits().
Desde Qt 6.8, se puede utilizar el parámetro opcional outOfBoundsPolicy para especificar cómo se gestionan los márgenes que están fuera de los límites.
Véase también setMargins() y margins().
bool QPageLayout::setLeftMargin(qreal leftMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
Establece el margen izquierdo del diseño de página en leftMargin. Devuelve true si el margen se ha establecido correctamente.
Las unidades utilizadas son las definidas actualmente para el diseño. Para utilizar unidades diferentes, llame primero a setUnits().
Desde Qt 6.8, se puede utilizar el parámetro opcional outOfBoundsPolicy para especificar cómo se gestionan los márgenes que están fuera de los límites.
Véase también setMargins() y margins().
bool QPageLayout::setMargins(const QMarginsF &margins, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
Establece los márgenes de página del diseño de página en margins. Devuelve true si los márgenes se han establecido correctamente.
Las unidades utilizadas son las definidas actualmente para el diseño. Para utilizar unidades diferentes, llame primero a setUnits().
Desde Qt 6.8, se puede utilizar el parámetro opcional outOfBoundsPolicy para especificar cómo se gestionan los márgenes que están fuera de los límites.
Véase también margins() y units().
void QPageLayout::setMinimumMargins(const QMarginsF &minMargins)
Establece los márgenes de página mínimos del diseño de página en minMargins.
No se recomienda anular los valores predeterminados establecidos para un tamaño de página, ya que puede tratarse del área mínima imprimible para un dispositivo de impresión físico.
Si se establece el modo StandardMode, los márgenes existentes se ajustarán al nuevo minMargins y al máximo permitido por el tamaño de página. Si se establece el modo FullPageMode, los márgenes existentes no se modificarán.
Véase también minimumMargins() y setMargins().
void QPageLayout::setMode(QPageLayout::Mode mode)
Establece un modo de diseño de página en mode.
Véase también mode().
void QPageLayout::setOrientation(QPageLayout::Orientation orientation)
Establece la orientación de la página del diseño de página en orientation.
Cambiar la orientación no afecta a los márgenes actuales ni a los márgenes mínimos.
Véase también orientation().
void QPageLayout::setPageSize(const QPageSize &pageSize, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0))
Establece el tamaño de página del diseño de página en pageSize.
Opcionalmente, define los márgenes mínimos permitidos minMargins, por ejemplo, los márgenes mínimos que puede imprimir un dispositivo de impresión físico; de lo contrario, los márgenes mínimos serán 0 por defecto.
Si se define StandardMode, los márgenes existentes se ajustarán a los nuevos márgenes mínimos y a los márgenes máximos permitidos por el tamaño de página. Si se define FullPageMode, los márgenes existentes no se modificarán.
Véase también pageSize().
bool QPageLayout::setRightMargin(qreal rightMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
Establece el margen derecho del diseño de página en rightMargin. Devuelve true si el margen se ha establecido correctamente.
Las unidades utilizadas son las definidas actualmente para el diseño. Para utilizar unidades diferentes, llame primero a setUnits().
Desde Qt 6.8, se puede utilizar el parámetro opcional outOfBoundsPolicy para especificar cómo se gestionan los márgenes que están fuera de los límites.
Véase también setMargins() y margins().
bool QPageLayout::setTopMargin(qreal topMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
Establece el margen superior de página del diseño de página en topMargin. Devuelve true si el margen se ha establecido correctamente.
Las unidades utilizadas son las definidas actualmente para el diseño. Para utilizar unidades diferentes, llame primero a setUnits().
Desde Qt 6.8, se puede utilizar el parámetro opcional outOfBoundsPolicy para especificar cómo se gestionan los márgenes que están fuera de los límites.
Véase también setMargins() y margins().
void QPageLayout::setUnits(QPageLayout::Unit units)
Establece la dirección units utilizada para definir el diseño de la página.
Véase también units().
[noexcept] void QPageLayout::swap(QPageLayout &other)
Cambia este diseño de página por other. Esta operación es muy rápida y nunca falla.
QPageLayout::Unit QPageLayout::units() const
Devuelve las unidades en las que está definido actualmente el diseño de página.
Véase también setUnits().
[noexcept] QPageLayout &QPageLayout::operator=(QPageLayout &&other)
Move-asigna other a esta instancia QPageLayout, transfiriendo la propiedad del puntero gestionado a esta instancia.
QPageLayout &QPageLayout::operator=(const QPageLayout &other)
Operador de asignación, asigna other a esto.
No miembros relacionados
bool operator!=(const QPageLayout &lhs, const QPageLayout &rhs)
Devuelve true si el diseño de página lhs no es igual al diseño de página rhs, es decir, si alguno de los atributos difiere.
Tenga en cuenta que se trata de una igualdad estricta, especialmente para el tamaño de página, donde el ID, el nombre y el tamaño de QPageSize deben coincidir exactamente, y los márgenes, donde las unidades deben coincidir.
Véase también QPageLayout::isEquivalentTo().
bool operator==(const QPageLayout &lhs, const QPageLayout &rhs)
Devuelve true si el diseño de página lhs es igual al diseño de página rhs, es decir, si todos los atributos son exactamente iguales.
Tenga en cuenta que se trata de una igualdad estricta, especialmente para el tamaño de página, donde el ID, el nombre y el tamaño de QPageSize deben coincidir exactamente, y los márgenes, donde las unidades deben coincidir.
Véase también QPageLayout::isEquivalentTo().
© 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.
