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 : |
- Liste de tous les membres, y compris les membres hérités
- QPagedPaintDevice fait partie des classes de peinture.
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.
| Constante | Valeur | Description |
|---|---|---|
QPagedPaintDevice::PdfVersion_1_4 | 0 | Un document compatible PDF 1.4 est généré. |
QPagedPaintDevice::PdfVersion_A1b | 1 | Un document compatible PDF/A-1b est généré. |
QPagedPaintDevice::PdfVersion_1_6 | 2 | Un 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) | 3 | Un 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.