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 |
- List of all members, including inherited members
- QPageRanges is part of Painting Classes, Printer and Printing APIs, and Implicitly Shared Classes.
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) |
Related Non-Members
| 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.
© 2024 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.
