Sur cette page

QPagedPaintDevice Class

La classe QPagedPaintDevice représente un dispositif de peinture prenant en charge plusieurs pages. Plus d'informations...

En-tête : #include <QPagedPaintDevice>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Hérite : QPaintDevice
Héritée par :

QPdfWriter et QPrinter

Types publics

enum PdfVersion { PdfVersion_1_4, PdfVersion_A1b, PdfVersion_1_6, PdfVersion_X4 }

Fonctions publiques

virtual ~QPagedPaintDevice()
virtual bool newPage() = 0
QPageLayout pageLayout() const
(since 6.0) QPageRanges pageRanges() const
virtual bool setPageLayout(const QPageLayout &newPageLayout)
virtual bool setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter)
virtual bool setPageOrientation(QPageLayout::Orientation orientation)
(since 6.0) virtual void setPageRanges(const QPageRanges &ranges)
virtual bool setPageSize(const QPageSize &pageSize)

Description détaillée

Les dispositifs de peinture paginée sont utilisés pour générer des sorties pour l'impression ou pour des formats tels que PDF. QPdfWriter et QPrinter en héritent.

Documentation sur les types de membres

enum QPagedPaintDevice::PdfVersion

L'énumération PdfVersion décrit la version du fichier PDF qui est produite par QPrinter ou QPdfWriter.

ConstanteValeurDescription de la version
QPagedPaintDevice::PdfVersion_1_40Un document compatible avec le format PDF 1.4 est produit.
QPagedPaintDevice::PdfVersion_A1b1Un document compatible PDF/A-1b est produit.
QPagedPaintDevice::PdfVersion_1_62Un document compatible avec le format PDF 1.6 est produit. Cette valeur a été ajoutée dans Qt 5.12.
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8)3Un document compatible avec le format PDF/X-4 est produit.

Documentation des fonctions membres

[virtual noexcept] QPagedPaintDevice::~QPagedPaintDevice()

Détruit l'objet.

[pure virtual] bool QPagedPaintDevice::newPage()

Démarre une nouvelle page. Retourne true en cas de succès.

QPageLayout QPagedPaintDevice::pageLayout() const

Renvoie la mise en page actuelle. Utilisez cette méthode pour accéder à QPageSize, QPageLayout::Orientation, QMarginsF, fullRect() et paintRect().

Notez que vous ne pouvez pas utiliser les paramètres sur l'objet retourné, vous devez appeler les paramètres individuels de QPagedPaintDevice ou utiliser setPageLayout().

Voir également setPageLayout(), setPageSize(), setPageOrientation() et setPageMargins().

[since 6.0] QPageRanges QPagedPaintDevice::pageRanges() const

Renvoie les plages de pages associées à ce périphérique.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi setPageRanges(), QPageRanges, QPrinter::fromPage(), et QPrinter::toPage().

[virtual] bool QPagedPaintDevice::setPageLayout(const QPageLayout &newPageLayout)

Définit la mise en page à newPageLayout.

Vous devez appeler cette méthode avant d'appeler QPainter::begin(), ou immédiatement avant d'appeler newPage() pour appliquer la nouvelle mise en page à une nouvelle page. Vous ne devez pas appeler de méthodes de peinture entre un appel à setPageLayout() et newPage(), car les mauvaises métriques de peinture pourraient être utilisées.

Retourne true si la mise en page a été réglée avec succès sur newPageLayout.

Voir également pageLayout().

[virtual] bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter)

Fixe la page margins définie dans la page units donnée.

Vous devez appeler cette méthode avant d'appeler QPainter::begin(), ou immédiatement avant d'appeler newPage() pour appliquer les nouvelles marges à une nouvelle page. Vous ne devez pas appeler de méthodes de peinture entre un appel à setPageMargins() et newPage(), car les mauvaises métriques de peinture pourraient être utilisées.

Pour obtenir les marges de page actuelles, utilisez pageLayout().margins().

Renvoie un message vrai si les marges de la page ont été définies avec succès sur margins.

Voir également pageLayout().

[virtual] bool QPagedPaintDevice::setPageOrientation(QPageLayout::Orientation orientation)

Définit la page orientation.

L'orientation de la page est utilisée pour définir l'orientation de la taille de la page lors de l'obtention du recto de la page.

Vous devez appeler cette fonction avant d'appeler QPainter::begin(), ou immédiatement avant d'appeler newPage() pour appliquer la nouvelle orientation à une nouvelle page. Vous ne devez pas appeler de méthodes de peinture entre un appel à setPageOrientation() et newPage(), car les mauvaises métriques de peinture pourraient être utilisées.

Pour obtenir l'adresse QPageLayout::Orientation actuelle, utilisez pageLayout().orientation().

Retourne true si l'orientation de la page a été réglée avec succès sur orientation.

Voir également pageLayout().

[virtual, since 6.0] void QPagedPaintDevice::setPageRanges(const QPageRanges &ranges)

Définit les plages de pages pour ce périphérique à ranges.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi pageRanges().

[virtual] bool QPagedPaintDevice::setPageSize(const QPageSize &pageSize)

Fixe la taille de la page à pageSize.

Pour obtenir la taille actuelle de QPageSize, utilisez pageLayout().pageSize().

Vous devez appeler cette méthode avant d'appeler QPainter::begin(), ou immédiatement avant d'appeler newPage() pour appliquer la nouvelle taille de page à une nouvelle page. Vous ne devez pas appeler de méthodes de peinture entre un appel à setPageSize() et newPage() car les mauvaises métriques de peinture pourraient être utilisées.

Retourne vrai si la taille de la page a été définie avec succès à pageSize.

Voir également pageLayout().

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