Sur cette page

QPagedPaintDevice Class

La classe `QPagedPaintDevice` représente un périphérique de dessin prenant en charge plusieurs pages. En savoir plus...

En-tête : #include <QPagedPaintDevice>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Hérite de : QPaintDevice
Hérité 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 périphériques de peinture paginés sont utilisés pour générer des sorties destinées à l'impression ou à des formats tels que le PDF. Les classes ` 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 généré par QPrinter ou QPdfWriter.

ConstanteValeurDescription
QPagedPaintDevice::PdfVersion_1_40Un document compatible PDF 1.4 est généré.
QPagedPaintDevice::PdfVersion_A1b1Un document compatible PDF/A-1b est généré.
QPagedPaintDevice::PdfVersion_1_62Un document compatible PDF 1.6 est généré. Cette valeur a été ajoutée dans Qt 5.12.
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8)3Un document compatible PDF/X-4 est généré.

Documentation des fonctions membres

[virtual noexcept] QPagedPaintDevice::~QPagedPaintDevice()

Détruit l'objet.

[pure virtual] bool QPagedPaintDevice::newPage()

Crée une nouvelle page. Renvoie « true » en cas de succès.

QPageLayout QPagedPaintDevice::pageLayout() const

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

Notez que vous ne pouvez pas utiliser les accesseurs sur l'objet renvoyé ; vous devez soit appeler les accesseurs individuels de QPagedPaintDevice, soit 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 également setPageRanges(), QPageRanges, QPrinter::fromPage() et QPrinter::toPage().

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

Définit la mise en page sur « 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 dessin entre l’appel à `setPageLayout()` et celui à ` newPage()`, car des paramètres de dessin incorrects pourraient être utilisés.

Renvoie true si la mise en page a été correctement définie sur newPageLayout.

Voir également pageLayout().

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

Définissez l'margins de page tel qu'il est défini dans l'units fourni.

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 dessin entre l’appel à `setPageMargins()` et celui à ` newPage()`, car des métriques de dessin erronées pourraient être utilisées.

Pour obtenir les marges de la page actuelle, utilisez ` pageLayout()`. `margins()`.

Renvoie « true » 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 l'orientation de la page.

L’orientation de la page sert à définir l’orientation du format de la page lors de l’obtention du rectangle de la page.

Vous devez appeler cette méthode 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 dessin entre l’appel à `setPageOrientation()` et celui à ` newPage()`, car des métriques de dessin erronées pourraient être utilisées.

QPageLayout::Orientation Pour obtenir l'orientation actuelle de la page, utilisez ` pageLayout()`.orientation().

Renvoie true si l'orientation de la page a été correctement définie 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 sur ranges.

Cette fonction a été introduite dans Qt 6.0.

Voir également pageRanges().

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

Définit la taille de la page sur pageSize.

Pour obtenir la taille de page actuelle d'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 appeler aucune méthode de dessin entre l’appel à `setPageSize()` et celui à ` newPage()`, car des paramètres de dessin erronés pourraient être utilisés.

Renvoie true si la taille de la page a été correctement définie sur 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.