Sur cette page

QPageRanges Class

La classe QPageRanges représente une collection de plages de pages. Plus d'informations...

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 QPagedPaintDevice::pageRanges() pour accéder à la collection de plages de pages associées à un périphérique paginé.

Documentation des fonctions membres

QPageRanges::QPageRanges()

Construit un objet QPageRanges vide.

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

Construit un objet QPageRanges en copiant other.

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

Construit un objet QPageRanges en se déplaçant de other.

[noexcept] QPageRanges::~QPageRanges()

Détruit les plages de pages.

void QPageRanges::addPage(int pageNumber)

Ajoute la page unique pageNumber aux plages.

Remarque : les numéros de page commencent par 1. Les tentatives d'ajout de numéros de page inférieurs à 1 seront ignorées et accompagnées d'un avertissement.

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

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

Remarque : les numéros de page commencent par 1. Les tentatives d'ajout de numéros de page inférieurs à 1 seront ignorées et accompagnées d'un avertissement.

void QPageRanges::clear()

Supprime toutes les plages de pages.

bool QPageRanges::contains(int pageNumber) const

Renvoie true si les plages comprennent la page pageNumber; sinon, renvoie false.

int QPageRanges::firstPage() const

Renvoie l'index de la première page couverte par les plages de pages, ou 0 si les plages de pages sont vides.

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

Construit et renvoie un objet QPageRanges rempli avec le ranges de la représentation de la chaîne.

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

En cas d'erreur d'analyse, il 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 couverte par les plages de pages, ou 0 si les plages de pages 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 l'objet QPageRanges.

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

Attribue other à cet objet QPageRanges.

Non-membres associés

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

Écrit pageRanges vers stream sous la forme d'une chaîne de caractères.

Voir aussi QPageRanges::toString.

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

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

Voir aussi 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.