En esta página

QPageSize Class

La clase QPageSize describe el tamaño y el nombre de un tamaño de página definido. Más información...

Encabezado: #include <QPageSize>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Tipos públicos

enum PageSizeId { A0, A1, A2, A3, A4, …, LastPageSize }
enum SizeMatchPolicy { FuzzyMatch, FuzzyOrientationMatch, ExactMatch }
enum Unit { Millimeter, Point, Inch, Pica, Didot, Cicero }

Funciones públicas

QPageSize()
QPageSize(QPageSize::PageSizeId pageSize)
QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize(const QPageSize &other)
~QPageSize()
QSizeF definitionSize() const
QPageSize::Unit definitionUnits() const
QPageSize::PageSizeId id() const
bool isEquivalentTo(const QPageSize &other) const
bool isValid() const
QString key() const
QString name() const
QRectF rect(QPageSize::Unit units) const
QRect rectPixels(int resolution) const
QRect rectPoints() const
QSizeF size(QPageSize::Unit units) const
QSize sizePixels(int resolution) const
QSize sizePoints() const
void swap(QPageSize &other)
int windowsId() const
QPageSize &operator=(QPageSize &&other)
QPageSize &operator=(const QPageSize &other)

Miembros públicos estáticos

QSizeF definitionSize(QPageSize::PageSizeId pageSizeId)
QPageSize::Unit definitionUnits(QPageSize::PageSizeId pageSizeId)
QPageSize::PageSizeId id(int windowsId)
QPageSize::PageSizeId id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize::PageSizeId id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QString key(QPageSize::PageSizeId pageSizeId)
QString name(QPageSize::PageSizeId pageSizeId)
QSizeF size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)
QSize sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)
QSize sizePoints(QPageSize::PageSizeId pageSizeId)
int windowsId(QPageSize::PageSizeId pageSizeId)
bool operator!=(const QPageSize &lhs, const QPageSize &rhs)
bool operator==(const QPageSize &lhs, const QPageSize &rhs)

Descripción detallada

Esta clase implementa la compatibilidad con el conjunto de tamaños de página estándar tal y como se definen en el estándar Adobe PostScript PPD v4.3. Define el conjunto estándar de tamaños de página en puntos, milímetros y pulgadas, y garantiza que estos tamaños se utilicen de forma coherente. Se pueden utilizar otras unidades de medida, pero los resultados se calcularán y, por lo tanto, es posible que no siempre sean coherentes. Los tamaños en puntos definidos son siempre números enteros; el resto de tamaños pueden ser fracciones de una unidad.

El tamaño definido siempre se indica en el orden «anchura × altura», sin que ello implique ninguna orientación de la página. Ten en cuenta que es posible definir tamaños de página en los que la anchura sea mayor que la altura, como por ejemplo QPageSize::Ledger, por lo que no puedes basarte en la comparación de los valores de anchura y altura para determinar la orientación de la página.

Por ejemplo, el A4 se define en la norma como 210 mm x 297 mm, 8,27 pulgadas x 11,69 pulgadas o 595 pt x 842 pt.

También puedes definir tamaños de página personalizados con nombres propios en las unidades que desees; este tamaño en unidades se conservará y se utilizará como base para todos los demás cálculos de tamaño en unidades.

Al crear un `QPageSize` utilizando una ` QSize ` personalizada, puedes elegir si deseas que `QPageSize` intente hacer coincidir el tamaño con un tamaño de página estándar. Por defecto, `QPaperSize` utiliza un modo de « FuzzyMatch », en el que hará coincidir un tamaño de página dado con un tamaño de página estándar si se encuentra dentro de un margen de 3 puntos PostScript respecto a un tamaño estándar definido. Se puede anular esta configuración para solicitar únicamente una coincidencia exacta, pero no se recomienda, ya que las conversiones entre unidades pueden provocar fácilmente una desviación de 3 puntos y dar lugar a tamaños de página incorrectos.

También se puede obtener una instancia de QPageSize consultando los tamaños de página compatibles con un dispositivo de impresión. En este caso, el nombre localizado que se devuelve es el definido por la propia impresora. Ten en cuenta que es posible que el dispositivo de impresión no sea compatible con el idioma de la configuración regional predeterminada actual.

La clase también proporciona métodos prácticos para convertir los identificadores de tamaño de página a y desde diversos tamaños de unidad.

Véase también QPagedPaintDevice y QPdfWriter.

Documentación sobre los tipos de miembros

enum QPageSize::PageSizeId

Este tipo de enumeración recoge los tamaños de página disponibles tal y como se definen en el estándar PPD de PostScript. Estos valores se recogen también en QPagedPaintDevice y QPrinter.

Los tamaños definidos son:

ConstanteValorDescripción
QPageSize::A03841 x 1189 mm
QPageSize::A14594 x 841 mm
QPageSize::A25420 x 594 mm
QPageSize::A36297 x 420 mm
QPageSize::A47210 x 297 mm, 8,26 x 11,69 pulgadas
QPageSize::A58148 x 210 mm
QPageSize::A69105 x 148 mm
QPageSize::A71074 x 105 mm
QPageSize::A81152 x 74 mm
QPageSize::A91237 x 52 mm
QPageSize::B0141000 x 1414 mm
QPageSize::B115707 x 1000 mm
QPageSize::B216500 x 707 mm
QPageSize::B317353 x 500 mm
QPageSize::B418250 x 353 mm
QPageSize::B519176 x 250 mm, 6,93 x 9,84 pulgadas
QPageSize::B620125 x 176 mm
QPageSize::B72188 x 125 mm
QPageSize::B82262 x 88 mm
QPageSize::B92344 x 62 mm
QPageSize::B102431 x 44 mm
QPageSize::C5E25163 x 229 mm
QPageSize::Comm10E26105 x 241 mm, sobre «U.S. Common 10»
QPageSize::DLE27110 x 220 mm
QPageSize::Executive27,5 x 10 pulgadas, 190,5 x 254 mm
QPageSize::Folio28210 x 330 mm
QPageSize::Ledger29431,8 x 279,4 mm
QPageSize::Legal18,5 x 14 pulgadas, 215,9 x 355,6 mm
QPageSize::Letter08,5 x 11 pulgadas, 215,9 x 279,4 mm
QPageSize::Tabloid30279,4 x 431,8 mm
QPageSize::Custom31Desconocido o un tamaño definido por el usuario.
QPageSize::A1013 
QPageSize::A3Extra32 
QPageSize::A4Extra33 
QPageSize::A4Plus34 
QPageSize::A4Small35 
QPageSize::A5Extra36 
QPageSize::B5Extra37 
QPageSize::JisB038 
QPageSize::JisB139 
QPageSize::JisB240 
QPageSize::JisB341 
QPageSize::JisB442 
QPageSize::JisB543 
QPageSize::JisB644,
QPageSize::JisB745 
QPageSize::JisB846 
QPageSize::JisB947 
QPageSize::JisB1048 
QPageSize::AnsiALetter= Carta
QPageSize::AnsiBLedger= Libro mayor
QPageSize::AnsiC49 
QPageSize::AnsiD50 
QPageSize::AnsiE51 
QPageSize::LegalExtra52 
QPageSize::LetterExtra53 
QPageSize::LetterPlus54 
QPageSize::LetterSmall55 
QPageSize::TabloidExtra56 
QPageSize::ArchA57 
QPageSize::ArchB58 
QPageSize::ArchC59 
QPageSize::ArchD60 
QPageSize::ArchE61 
QPageSize::Imperial7x962 
QPageSize::Imperial8x1063 
QPageSize::Imperial9x1164 
QPageSize::Imperial9x1265 
QPageSize::Imperial10x1166 
QPageSize::Imperial10x1367 
QPageSize::Imperial10x1468 
QPageSize::Imperial12x1169 
QPageSize::Imperial15x1170 
QPageSize::ExecutiveStandard71 
QPageSize::Note72 
QPageSize::Quarto73 
QPageSize::Statement74 
QPageSize::SuperA75 
QPageSize::SuperB76 
QPageSize::Postcard77 
QPageSize::DoublePostcard78 
QPageSize::Prc16K79 
QPageSize::Prc32K80 
QPageSize::Prc32KBig81 
QPageSize::FanFoldUS82 
QPageSize::FanFoldGerman83 
QPageSize::FanFoldGermanLegal84 
QPageSize::EnvelopeB485 
QPageSize::EnvelopeB586 
QPageSize::EnvelopeB687 
QPageSize::EnvelopeC088 
QPageSize::EnvelopeC189 
QPageSize::EnvelopeC290 
QPageSize::EnvelopeC391 
QPageSize::EnvelopeC492 
QPageSize::EnvelopeC5C5E= C5E
QPageSize::EnvelopeC693 
QPageSize::EnvelopeC6594 
QPageSize::EnvelopeC795 
QPageSize::EnvelopeDLDLE= DLE
QPageSize::Envelope996 
QPageSize::Envelope10Comm10E= Comm10E
QPageSize::Envelope1197 
QPageSize::Envelope1298 
QPageSize::Envelope1499 
QPageSize::EnvelopeMonarch100 
QPageSize::EnvelopePersonal101 
QPageSize::EnvelopeChou3102 
QPageSize::EnvelopeChou4103 
QPageSize::EnvelopeInvite104 
QPageSize::EnvelopeItalian105 
QPageSize::EnvelopeKaku2106 
QPageSize::EnvelopeKaku3107 
QPageSize::EnvelopePrc1108 
QPageSize::EnvelopePrc2109 
QPageSize::EnvelopePrc3110 
QPageSize::EnvelopePrc4111 
QPageSize::EnvelopePrc5112 
QPageSize::EnvelopePrc6113 
QPageSize::EnvelopePrc7114 
QPageSize::EnvelopePrc8115 
QPageSize::EnvelopePrc9116 
QPageSize::EnvelopePrc10117 
QPageSize::EnvelopeYou4118 
QPageSize::LastPageSizeEnvelopeYou4= EnvelopeYou4

Por motivos históricos, QPageSize::Executive no coincide con el tamaño estándar «Executive» de PostScript y Windows; utilice en su lugar QPageSize::ExecutiveStandard.

El tamaño estándar de PostScript QPageSize::Folio difiere del tamaño DMPAPER_FOLIO de Windows; utilice el tamaño estándar de PostScript QPageSize::FanFoldGermanLegal si es necesario.

enum QPageSize::SizeMatchPolicy

ConstanteValorDescripción
QPageSize::FuzzyMatch0Se ajusta a un tamaño de página estándar si se encuentra dentro del margen de tolerancia.
QPageSize::FuzzyOrientationMatch1Se ajusta a un tamaño de página estándar si se encuentra dentro del margen de tolerancia, independientemente de la orientación.
QPageSize::ExactMatch2Solo se ajustará a un tamaño de página estándar si las dimensiones coinciden exactamente.

enum QPageSize::Unit

Este tipo de enumeración se utiliza para especificar la unidad de medida del tamaño de las páginas.

ConstanteValorDescripción
QPageSize::Millimeter0 
QPageSize::Point11/72 de pulgada
QPageSize::Inch2 
QPageSize::Pica31/72 de pie, 1/6 de pulgada, 12 puntos
QPageSize::Didot41/72 de pulgada francesa, 0,375 mm
QPageSize::Cicero51/6 de pulgada francesa, 12 Didot, 4,5 mm

Documentación de funciones de miembro

QPageSize::QPageSize()

Crea un objeto `QPageSize` con valor nulo.

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

Crea un objeto `QPageSize` con el tamaño estándar ` pageSize`.

Si pageSize es QPageSize::Custom, el QPageSize resultante no será válido. En su lugar, utiliza el constructor de tamaño personalizado.

[explicit] QPageSize::QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Crea un QPageSize del pointSize dado en puntos utilizando el matchPolicy correspondiente.

Si el « pointSize » proporcionado coincide con un « QPageSize::PageSizeId » estándar, se utilizará ese tamaño de página. Ten en cuenta que, si el « matchPolicy » es « FuzzyMatch », esto puede provocar que el « pointSize » se ajuste al tamaño estándar. Para evitar que esto ocurra, utiliza un « matchPolicy » de « ExactMatch » en su lugar.

Si el pointSize proporcionado no es un QPageSize::PageSizeId estándar, se creará un tamaño QPageSize::Custom.

Si name es nulo, se utilizará el nombre localizado estándar. Si se trata de un tamaño de página personalizado, se creará un nombre personalizado con el formato «Personalizado (anchura x altura)».

El valor predeterminado de « matchPolicy » es « FuzzyMatch ».

[explicit] QPageSize::QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Crea una página personalizada a partir de la URL size en units.

Si el size especificado coincide con un QPageSize::PageSizeId estándar, se utilizará el tamaño de esa página. Ten en cuenta que, si el matchPolicy es FuzzyMatch, esto puede provocar que el size se ajuste al tamaño estándar. Para evitar que esto ocurra, utiliza en su lugar un matchPolicy de ExactMatch.

Si el size proporcionado no es un QPageSize::PageSizeId estándar, se creará un tamaño QPageSize::Custom. Se conservará el tamaño de la unidad original y se utilizará como base para todos los demás cálculos de tamaño de unidad.

Si name es nulo, se creará un nombre personalizado con el formato «Personalizado (ancho x alto)», donde el tamaño se expresa en las unidades proporcionadas.

QPageSize::QPageSize(const QPageSize &other)

Constructor de copia: copia ` other ` en `this`.

[noexcept] QPageSize::~QPageSize()

Elimina la página.

QSizeF QPageSize::definitionSize() const

Devuelve el tamaño definido de la página.

En el caso de un tamaño de página estándar, será el tamaño definido en la norma correspondiente; es decir, el tamaño ISO A4 se definirá en milímetros, mientras que el tamaño ANSI Letter se definirá en pulgadas.

En el caso de un tamaño de página personalizado, será el tamaño original utilizado para crear el objeto de tamaño de página.

Si el objeto « QPageSize » no es válido, el objeto « QSizeF » tampoco lo será.

Véase también definitionUnits().

[static] QSizeF QPageSize::definitionSize(QPageSize::PageSizeId pageSizeId)

Devuelve el tamaño de definición del tipo estándar ` pageSizeId`.

Para obtener las unidades de definición, llama a QPageSize::definitionUnits().

QPageSize::Unit QPageSize::definitionUnits() const

Devuelve las unidades de definición del tamaño de la página.

En el caso de un tamaño de página estándar, se tratará de las unidades definidas en la norma correspondiente; es decir, el formato ISO A4 se definirá en milímetros, mientras que el formato ANSI Letter se definirá en pulgadas.

En el caso de un tamaño de página personalizado, se tratará de las unidades originales utilizadas para crear el objeto de tamaño de página.

Si el ` QPageSize ` no es válido, el ` QPageSize::Unit ` tampoco lo será.

Véase también definitionSize().

[static] QPageSize::Unit QPageSize::definitionUnits(QPageSize::PageSizeId pageSizeId)

Devuelve las unidades de definición del estándar « pageSizeId ».

Para obtener el tamaño de definición, llama a QPageSize::definitionSize().

QPageSize::PageSizeId QPageSize::id() const

Devuelve el ` QPageSize::PageSizeId ` estándar de la página, o bien ` QPageSize::Custom`.

Si el QPageSize no es válido, el ID será QPageSize::Custom.

[static] QPageSize::PageSizeId QPageSize::id(int windowsId)

Devuelve el objeto ` PageSizeId ` correspondiente al valor dado de la enumeración `DMPAPER` de Windows: ` windowsId`.

Si no hay ningún « PageSizeId » que coincida, se devuelve QPageSize::Custom.

[static] QPageSize::PageSizeId QPageSize::id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Devuelve el ` QPageSize::PageSizeId ` estándar del ` pointSize ` dado en puntos, utilizando el ` matchPolicy` especificado.

Si se utiliza FuzzyMatch, es posible que el tamaño en puntos del PageSizeId devuelto no coincida exactamente con el pointSize que se haya pasado. Se debe llamar a QPageSize::sizePoints() utilizando el PageSizeId devuelto para averiguar el tamaño real en puntos del PageSizeId antes de utilizarlo en cualquier cálculo.

[static] QPageSize::PageSizeId QPageSize::id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Devuelve el « QPageSize::PageSizeId » estándar de la « size » indicada en « units » utilizando el « matchPolicy » especificado.

Si se utiliza FuzzyMatch, es posible que el tamaño de la unidad del PageSizeId devuelto no coincida exactamente con el size que se ha pasado. Se debe llamar a QPageSize::size() utilizando el PageSizeId devuelto para averiguar el tamaño real de la unidad del PageSizeId antes de utilizarlo en cualquier cálculo.

bool QPageSize::isEquivalentTo(const QPageSize &other) const

Devuelve « true » si esta página es equivalente a la página « other », es decir, si la página tiene el mismo tamaño independientemente de otros atributos, como el nombre.

bool QPageSize::isValid() const

Devuelve ` true ` si el tamaño de página es válido.

El tamaño de la página puede no ser válido si se ha creado con un PageSizeId no válido, o con un QSize o QSizeF negativo o no válido, o con el constructor nulo.

QString QPageSize::key() const

Devuelve la clave única del tamaño de la página.

Por defecto, se trata de la palabra clave estándar «mediaOption» del PPD para el tamaño de página, o de la clave de formato personalizado del PPD. Si la instancia de « QPageSize » se ha obtenido de un dispositivo de impresión, esta será la clave proporcionada por dicho dispositivo y puede diferir de la clave estándar.

Si el objeto ` QPageSize ` no es válido, la clave será una cadena vacía.

Esta clave nunca debe mostrarse a los usuarios finales, ya que es una clave exclusivamente interna. Para obtener un nombre legible para el usuario, utilice name().

Véase también name().

[static] QString QPageSize::key(QPageSize::PageSizeId pageSizeId)

Devuelve la palabra clave «mediaOption» de PPD de la configuración estándar « pageSizeId ».

Si el ` QPageSize ` no es válido, la clave estará vacía.

QString QPageSize::name() const

Devuelve un nombre localizado y legible para el tamaño de la página.

Si la instancia de ` QPageSize ` se ha obtenido de un dispositivo de impresión, se utilizará el nombre proporcionado por dicho dispositivo. Ten en cuenta que es posible que un dispositivo de impresión no admita el idioma predeterminado de la configuración regional actual.

Si el objeto ` QPageSize ` no es válido, el nombre será una cadena vacía.

[static] QString QPageSize::name(QPageSize::PageSizeId pageSizeId)

Devuelve el nombre traducido de la función estándar « pageSizeId ».

Si el QPageSize no es válido, el nombre quedará en blanco.

QRectF QPageSize::rect(QPageSize::Unit units) const

Devuelve el rectángulo de la página en el formato requerido units.

Si el ` QPageSize ` no es válido, el ` QRect ` tampoco lo será.

QRect QPageSize::rectPixels(int resolution) const

Devuelve el rectángulo de la página en píxeles del dispositivo en la posición indicada resolution.

Si el « QPageSize » no es válido, el « QRect » tampoco lo será.

QRect QPageSize::rectPoints() const

Devuelve el rectángulo de la página en puntos PostScript (1/72 de pulgada).

Si la variable « QPageSize » no es válida, la variable « QRect » tampoco lo será.

QSizeF QPageSize::size(QPageSize::Unit units) const

Devuelve el tamaño de la página en el formato requerido « units ».

Si el ` QPageSize ` no es válido, el ` QSizeF ` tampoco lo será.

[static] QSizeF QPageSize::size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)

Devuelve el tamaño del archivo « pageSizeId » en el formato solicitado « units ».

QSize QPageSize::sizePixels(int resolution) const

Devuelve el tamaño de la página en píxeles del dispositivo (Device Pixels) en el resolution especificado.

Si el ` QPageSize ` no es válido, el ` QSize ` tampoco lo será.

[static] QSize QPageSize::sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)

Devuelve el tamaño del archivo « pageSizeId » en píxeles de dispositivo para el archivo « resolution » indicado.

QSize QPageSize::sizePoints() const

Devuelve el tamaño de la página en puntos PostScript (1/72 de pulgada).

Si el « QPageSize » no es válido, el « QSize » tampoco lo será.

[static] QSize QPageSize::sizePoints(QPageSize::PageSizeId pageSizeId)

Devuelve el tamaño del « pageSizeId » estándar en puntos.

[noexcept] void QPageSize::swap(QPageSize &other)

Cambia esta dirección QPageSize por other. Esta operación es muy rápida y nunca falla.

int QPageSize::windowsId() const

Devuelve el valor de la enumeración DMPAPER de Windows correspondiente al tamaño de la página.

No todos los tamaños de página PPD válidos tienen un equivalente en Windows; en ese caso, se devolverá 0.

Si el « QPageSize » no es válido, el identificador de Windows será 0.

Véase también id().

[static] int QPageSize::windowsId(QPageSize::PageSizeId pageSizeId)

Devuelve el valor de la enumeración DMPAPER de Windows correspondiente al tamaño de página estándar « pageSizeId ».

No todos los tamaños de página PPD válidos tienen un equivalente en Windows; en ese caso, se devolverá 0.

[noexcept] QPageSize &QPageSize::operator=(QPageSize &&other)

La operación «move-assign» asigna ` other ` a esta instancia de ` QPageSize `, transfiriendo la propiedad del puntero gestionado a esta instancia.

QPageSize &QPageSize::operator=(const QPageSize &other)

Operador de asignación: asigna « other » a «this».

Elementos no miembros relacionados

bool operator!=(const QPageSize &lhs, const QPageSize &rhs)

Devuelve « true » si el tamaño de la página lhs no coincide con el de la página rhs, es decir, si el tamaño de la página tiene atributos diferentes. Los atributos actuales son «size» y «name».

bool operator==(const QPageSize &lhs, const QPageSize &rhs)

Devuelve « true » si el tamaño de la página « lhs » es igual al tamaño de la página « rhs », es decir, si los tamaños de las páginas tienen los mismos atributos. Los atributos actuales son «size» y «name».

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