En esta página

QPageRanges Class

La clase `QPageRanges` representa una colección de rangos de páginas. Más información...

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

Tipos públicos

struct Range

Funciones públicas

QPageRanges()
QPageRanges(const QPageRanges &other)
QPageRanges(QPageRanges &&other)
~QPageRanges()
void addPage(int pageNumber)
void addRange(int from, int to)
void clear()
bool contains(int pageNumber) const
int firstPage() const
bool isEmpty() const
int lastPage() const
QList<QPageRanges::Range> toRangeList() const
QString toString() const
QPageRanges &operator=(QPageRanges &&other)
QPageRanges &operator=(const QPageRanges &other)

Miembros públicos estáticos

QPageRanges fromString(const QString &ranges)
QDataStream &operator<<(QDataStream &stream, const QPageRanges &pageRanges)
QDataStream &operator>>(QDataStream &stream, QPageRanges &pageRanges)

Descripción detallada

Utiliza QPagedPaintDevice::pageRanges() para acceder a la colección de rangos de páginas asociados a un dispositivo paginado.

Documentación de la función de miembro

QPageRanges::QPageRanges()

Crea un objeto QPageRanges vacío.

[noexcept] QPageRanges::QPageRanges(const QPageRanges &other)

Crea un objeto `QPageRanges` copiando ` other`.

[constexpr noexcept default] QPageRanges::QPageRanges(QPageRanges &&other)

Crea un objeto QPageRanges a partir de other.

[noexcept] QPageRanges::~QPageRanges()

Elimina los rangos de páginas.

void QPageRanges::addPage(int pageNumber)

Añade la página única pageNumber a los rangos.

Nota: La numeraciónde las páginas comienza por el 1. Los intentos de añadir números de página inferiores a 1 se ignorarán y se mostrará una advertencia.

void QPageRanges::addRange(int from, int to)

Añade el rango especificado con « from » y « to » a los rangos.

Nota: Los númerosde página comienzan por 1. Los intentos de añadir números de página inferiores a 1 se ignorarán y se mostrará una advertencia.

void QPageRanges::clear()

Elimina todos los rangos de páginas.

bool QPageRanges::contains(int pageNumber) const

Devuelve « true » si los rangos incluyen la página « pageNumber »; en caso contrario, devuelve « false ».

int QPageRanges::firstPage() const

Devuelve el índice de la primera página incluida en los rangos de páginas, o 0 si los rangos de páginas están vacíos.

[static] QPageRanges QPageRanges::fromString(const QString &ranges)

Crea y devuelve un objeto ` QPageRanges ` rellenado con el objeto ` ranges ` a partir de la representación en forma de cadena.

QPrinter printer;
QPageRanges ranges = QPageRanges::fromString("1-3,6-7");
printer.setPageRanges(ranges);

En caso de error de análisis, devuelve un objeto ` QPageRanges ` vacío.

Véase también isEmpty().

bool QPageRanges::isEmpty() const

Devuelve « true » si los rangos están vacíos; en caso contrario, devuelve « false ».

int QPageRanges::lastPage() const

Devuelve el índice de la última página incluida en los rangos de páginas, o 0 si los rangos de páginas están vacíos.

QList<QPageRanges::Range> QPageRanges::toRangeList() const

Devuelve una lista con los valores de los rangos.

QString QPageRanges::toString() const

Devuelve la representación en forma de cadena de los rangos de páginas.

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

Traslada el objeto « other » a este objeto « QPageRanges ».

[noexcept] QPageRanges &QPageRanges::operator=(const QPageRanges &other)

Asigna « other » a este objeto « QPageRanges ».

Elementos no miembros relacionados

QDataStream &operator<<(QDataStream &stream, const QPageRanges &pageRanges)

Escribe « pageRanges » en « stream » como una cadena de rango.

Véase también QPageRanges::toString.

QDataStream &operator>>(QDataStream &stream, QPageRanges &pageRanges)

Lee una cadena que indica un rango de páginas de stream y la almacena en pageRanges.

Véase también QPageRanges::fromString.

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