QPageRanges Class Reference

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

#include <qpageranges.h>

Collaboration diagram for QPageRanges:

Classes
struct	Range
	\inmodule QtGui More...

Public Member Functions
	QPageRanges ()
	Constructs an empty QPageRanges object.
	~QPageRanges ()
	Destroys the page ranges.
	QPageRanges (const QPageRanges &other) noexcept
	Constructs a QPageRanges object by copying other.
QPageRanges &	operator= (const QPageRanges &other) noexcept
	Assigns other to this QPageRanges object.
	QPageRanges (QPageRanges &&other) noexcept=default
	Constructs a QPageRanges object by moving from other.
void	swap (QPageRanges &other) noexcept
void	addPage (int pageNumber)
	Adds the single page pageNumber to the ranges.
void	addRange (int from, int to)
	Adds the range specified with from and to to the ranges.
QList< Range >	toRangeList () const
	Returns a list with the values of the ranges.
void	clear ()
	Removes all page ranges.
QString	toString () const
	Returns the string representation of the page ranges.
bool	contains (int pageNumber) const
	Returns true if the ranges include the page pageNumber; otherwise returns false.
bool	isEmpty () const
	Returns true if the ranges are empty; otherwise returns false.
int	firstPage () const
	Returns the index of the first page covered by the page ranges, or 0 if the page ranges are empty.
int	lastPage () const
	Returns the index of the last page covered by the page ranges, or 0 if the page ranges are empty.
void	detach ()

Static Public Member Functions
static QPageRanges	fromString (const QString &ranges)
	Constructs and returns a QPageRanges object populated with the ranges from the string representation.

Friends
bool	operator== (const QPageRanges &lhs, const QPageRanges &rhs) noexcept
bool	operator!= (const QPageRanges &lhs, const QPageRanges &rhs) noexcept

Related Symbols
(Note that these are not member symbols.)
QDataStream &	operator<< (QDataStream &stream, const QPageRanges &pageRanges)
	Writes pageRanges to stream as a range string.
QDataStream &	operator>> (QDataStream &stream, QPageRanges &pageRanges)
	Reads a page ranges string from stream and stores it in pageRanges.

Detailed Description

The QPageRanges class represents a collection of page ranges.

\inmodule QtGui

Since

6.0

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

Definition at line 20 of file qpageranges.h.

Constructor & Destructor Documentation

QPageRanges() [1/3]

QPageRanges::QPageRanges ( )

default

Constructs an empty QPageRanges object.

~QPageRanges()

QPageRanges::~QPageRanges ( )

default

Destroys the page ranges.

QPageRanges() [2/3]

QPageRanges::QPageRanges ( const QPageRanges & other )

defaultnoexcept

Constructs a QPageRanges object by copying other.

QPageRanges() [3/3]

QPageRanges::QPageRanges ( QPageRanges && other )

defaultnoexcept

Constructs a QPageRanges object by moving from other.

Member Function Documentation

addPage()

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.

Definition at line 91 of file qpageranges.cpp.

addRange()

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.

Definition at line 109 of file qpageranges.cpp.

clear()

void QPageRanges::clear

(

)

Removes all page ranges.

Definition at line 136 of file qpageranges.cpp.

contains()

bool QPageRanges::contains

(

int

pageNumber

)

const

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

Definition at line 230 of file qpageranges.cpp.

detach()

void QPageRanges::detach

(

)

Definition at line 287 of file qpageranges.cpp.

firstPage()

int QPageRanges::firstPage

(

)

const

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

Definition at line 254 of file qpageranges.cpp.

fromString()

QPageRanges QPageRanges::fromString ( const QString & ranges )

static

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()

Definition at line 155 of file qpageranges.cpp.

isEmpty()

bool QPageRanges::isEmpty

(

)

const

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

Definition at line 245 of file qpageranges.cpp.

lastPage()

int QPageRanges::lastPage

(

)

const

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

Definition at line 265 of file qpageranges.cpp.

operator=()

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

defaultnoexcept

Assigns other to this QPageRanges object.

Moves other into this QPageRanges object.

swap()

void QPageRanges::swap ( QPageRanges & other )

inlinenoexcept

Definition at line 31 of file qpageranges.h.

toRangeList()

QList< QPageRanges::Range > QPageRanges::toRangeList

(

)

const

Returns a list with the values of the ranges.

Definition at line 126 of file qpageranges.cpp.

toString()

QString QPageRanges::toString

(

)

const

Returns the string representation of the page ranges.

Definition at line 205 of file qpageranges.cpp.

Friends And Related Symbol Documentation

operator!=

bool operator!= ( const QPageRanges & lhs, const QPageRanges & rhs )

friend

Definition at line 36 of file qpageranges.h.

operator<<()

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

related

Writes pageRanges to stream as a range string.

See also

QPageRanges::toString

Definition at line 305 of file qpageranges.cpp.

operator==

bool operator== ( const QPageRanges & lhs, const QPageRanges & rhs )

friend

Definition at line 34 of file qpageranges.h.

operator>>()

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

related

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

See also

QPageRanges::fromString

Definition at line 320 of file qpageranges.cpp.

---

The documentation for this class was generated from the following files:

• qtbase/src/gui/painting/qpageranges.h (05fc3aef53348fb58be6308076e000825b704e58)
• qtbase/src/gui/painting/qpageranges.cpp (14505ca2788cbb6944d81712e757f78d80f744f4)