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 : |
- 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 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.
| Constante | Valeur | Description de la version |
|---|---|---|
QPagedPaintDevice::PdfVersion_1_4 | 0 | Un document compatible avec le format PDF 1.4 est produit. |
QPagedPaintDevice::PdfVersion_A1b | 1 | Un document compatible PDF/A-1b est produit. |
QPagedPaintDevice::PdfVersion_1_6 | 2 | Un 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) | 3 | Un 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.