QPageRanges Class▲
-
Header: QPageRanges
-
Since: Qt 6.0
-
CMake:
find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
-
qmake: QT += gui
-
Group: QPageRanges is part of Painting Classes, printing, shared
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.
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.
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▲
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)▲
QDataStream &operator>>(QDataStream &stream, QPageRanges &pageRanges)▲
Reads a page ranges string from stream and stores it in pageRanges.
See Also▲
See also QPageRanges::fromString