Sur cette page

QPageRanges Class

La classe QPageRanges représente un ensemble de plages de pages. En savoir plus...

En-tête : #include <QPageRanges>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Depuis : Qt 6.0

Types publics

struct Range

Fonctions publiques

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

Membres publics statiques

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

Description détaillée

Utilisez la fonction QPagedPaintDevice::pageRanges() pour accéder à l'ensemble des plages de pages associées à un périphérique paginé.

Documentation sur les fonctions membres

QPageRanges::QPageRanges()

Crée un objet `QPageRanges` vide.

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

Crée un objet `QPageRanges` en copiant ` other`.

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

Crée un objet QPageRanges à partir de other.

[noexcept] QPageRanges::~QPageRanges()

Supprime les plages de pages.

void QPageRanges::addPage(int pageNumber)

Ajoute la page unique pageNumber aux plages.

Remarque : la numérotationdes pages commence à 1. Toute tentative d'ajout d'un numéro de page inférieur à 1 sera ignorée et donnera lieu à un avertissement.

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

Ajoute la plage spécifiée avec from et to aux plages.

Remarque : la numérotationdes pages commence à 1. Toute tentative d'ajout de numéros de page inférieurs à 1 sera ignorée et donnera lieu à un message d'avertissement.

void QPageRanges::clear()

Supprime toutes les plages de pages.

bool QPageRanges::contains(int pageNumber) const

Renvoie « true » si les plages incluent la page « pageNumber » ; sinon, renvoie « false ».

int QPageRanges::firstPage() const

Renvoie l'index de la première page comprise dans les plages de pages, ou 0 si celles-ci sont vides.

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

Construit et renvoie un objet ` QPageRanges ` renseigné avec les données de la chaîne de caractères ` ranges `.

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

En cas d'erreur d'analyse, renvoie un objet ` QPageRanges ` vide.

Voir aussi isEmpty().

bool QPageRanges::isEmpty() const

Renvoie « true » si les plages sont vides ; sinon, renvoie « false ».

int QPageRanges::lastPage() const

Renvoie l'index de la dernière page comprise dans les plages de pages, ou 0 si celles-ci sont vides.

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

Renvoie une liste contenant les valeurs des plages.

QString QPageRanges::toString() const

Renvoie la représentation sous forme de chaîne de caractères des plages de pages.

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

Déplace « other » dans cet objet « QPageRanges ».

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

Attribue la propriété « other » à cet objet « QPageRanges ».

Éléments non membres associés

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

Écrit la chaîne « pageRanges » dans le fichier « stream ».

Voir également QPageRanges::toString.

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

Lit une chaîne indiquant des plages de pages à partir de stream et la stocke dans pageRanges.

Voir également QPageRanges::fromString.

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