QPageRanges Class

The QPageRanges class represents a collection of page ranges. More...

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

Public Types

struct Range

Public Functions

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=(const QPageRanges &other)
QPageRanges &operator=(QPageRanges &&other)

Static Public Members

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

Detailed Description

Use QPagedPaintDevice::pageRanges() to access the collection of page ranges associated with a paged device.

Member Function Documentation

QPageRanges::QPageRanges()

Constructs an empty QPageRanges object.

QPageRanges::QPageRanges(const QPageRanges &other)

Constructs a QPageRanges object by copying other.

QPageRanges::QPageRanges(QPageRanges &&other)

Constructs a QPageRanges object by moving from other.

QPageRanges::~QPageRanges()

Destroys the page ranges.

void QPageRanges::addPage(int pageNumber)

Adds the single page pageNumber to the ranges.

Note: Page numbers start with 1. Attempts to add page numbers smaller than 1 will be ignored with a warning.

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

Adds the range specified with from and to to the ranges.

Note: Page numbers start with 1. Attempts to add page numbers smaller than 1 will be ignored with a warning.

void QPageRanges::clear()

Removes all page ranges.

bool QPageRanges::contains(int pageNumber) const

Returns true if the ranges include the page pageNumber; otherwise returns false.

int QPageRanges::firstPage() const

Returns the index of the first page covered by the page ranges, or 0 if the page ranges are empty.

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

Constructs and returns a QPageRanges object populated with the ranges from the string representation.

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

In case of parsing error, returns an empty QPageRanges object.

See also isEmpty().

bool QPageRanges::isEmpty() const

Returns true if the ranges are empty; otherwise returns false.

int QPageRanges::lastPage() const

Returns the index of the last page covered by the page ranges, or 0 if the page ranges are empty.

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

Returns a list with the values of the ranges.

QString QPageRanges::toString() const

Returns the string representation of the page ranges.

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

Assigns other to this QPageRanges object.

QPageRanges &QPageRanges::operator=(QPageRanges &&other)

Moves other into this QPageRanges object.

Related Non-Members

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

Writes pageRanges to stream as a range string.

See also QPageRanges::toString.

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

Reads a page ranges string from stream and stores it in pageRanges.

See also QPageRanges::fromString.

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