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.

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

Constructs a QPageRanges object by copying other.

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

Constructs a QPageRanges object by moving from other.

[noexcept] 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.

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

Assigns other to this QPageRanges object.

[noexcept] 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.