QPrintPreviewWidget Class
La classe QPrintPreviewWidget fournit un widget permettant de prévisualiser la mise en page des documents destinés à l'impression. En savoir plus...
| En-tête : | #include <QPrintPreviewWidget> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake : | QT += printsupport |
| Hérite de : | QWidget |
- Liste de tous les membres, y compris les membres hérités
- QPrintPreviewWidget fait partie des API d'impression et d'imprimantes.
Types publics
| enum | ViewMode { SinglePageView, FacingPagesView, AllPagesView } |
| enum | ZoomMode { CustomZoom, FitToWidth, FitInView } |
Fonctions publiques
| QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| virtual | ~QPrintPreviewWidget() |
| int | currentPage() const |
| QPageLayout::Orientation | orientation() const |
| int | pageCount() const |
| QPrintPreviewWidget::ViewMode | viewMode() const |
| qreal | zoomFactor() const |
| QPrintPreviewWidget::ZoomMode | zoomMode() const |
Fonctions publiques réimplémentées
| virtual void | setVisible(bool visible) override |
Slots publics
| void | fitInView() |
| void | fitToWidth() |
| void | print() |
| void | setAllPagesViewMode() |
| void | setCurrentPage(int page) |
| void | setFacingPagesViewMode() |
| void | setLandscapeOrientation() |
| void | setOrientation(QPageLayout::Orientation orientation) |
| void | setPortraitOrientation() |
| void | setSinglePageViewMode() |
| void | setViewMode(QPrintPreviewWidget::ViewMode mode) |
| void | setZoomFactor(qreal factor) |
| void | setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode) |
| void | updatePreview() |
| void | zoomIn(qreal factor = 1.1) |
| void | zoomOut(qreal factor = 1.1) |
Signaux
| void | paintRequested(QPrinter *printer) |
| void | previewChanged() |
Description détaillée
QPrintPreviewDialog utilise en interne un QPrintPreviewWidget, dont le but est de permettre l’intégration de l’aperçu dans d’autres widgets. Il permet également de créer une interface utilisateur différente de celle fournie par défaut avec QPrintPreviewDialog.
L'utilisation de QPrintPreviewWidget est très simple :
- Créer le QPrintPreviewWidget
Construisez le QPrintPreviewWidget soit en lui passant un objet QPrinter existant, soit en demandant à QPrintPreviewWidget de créer pour vous un objet QPrinter construit par défaut.
- Connectez le signal ` paintRequested()` à un slot.
Lorsque le widget doit générer un ensemble de pages d’aperçu, un signal ` paintRequested()` est émis par le widget. Connectez un slot à ce signal, puis dessinez sur l’objet ` QPrinter ` passé en paramètre du signal. Appelez ` QPrinter::newPage()` pour créer une nouvelle page dans l’aperçu.
Voir également QPrinter, QPrintDialog, QPageSetupDialog et QPrintPreviewDialog.
Documentation sur les types de membres
enum QPrintPreviewWidget::ViewMode
Cette énumération sert à décrire le mode d'affichage du widget d'aperçu.
| Constante | Valeur | Description |
|---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | Mode dans lequel les pages de l'aperçu sont affichées une par une. |
QPrintPreviewWidget::FacingPagesView | 1 | Mode dans lequel les pages en vis-à-vis sont affichées dans l'aperçu. |
QPrintPreviewWidget::AllPagesView | 2 | Mode d'affichage permettant de visualiser toutes les pages de l'aperçu. |
enum QPrintPreviewWidget::ZoomMode
Cette énumération sert à décrire le mode de zoom du widget d'aperçu.
| Constante | Valeur | Description |
|---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | Le zoom est défini sur une valeur personnalisée. |
QPrintPreviewWidget::FitToWidth | 1 | Ce mode adapte la page actuelle à la largeur de la vue. |
QPrintPreviewWidget::FitInView | 2 | Ce mode adapte la page actuelle à l'intérieur de la fenêtre d'affichage. |
Documentation des fonctions membres
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Crée un objet `QPrintPreviewWidget` basé sur ` printer ` et dont le widget parent est ` parent `. Les indicateurs du widget ` flags ` sont transmis au constructeur de ` QWidget `.
Voir également QWidget::setWindowFlags().
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Cela entraînera la création par QPrintPreviewWidget d’un objet interne de type ` QPrinter `, instancié par défaut, qui sera utilisé pour générer l’aperçu.
Il s’agit d’une fonction surchargée.
[virtual noexcept] QPrintPreviewWidget::~QPrintPreviewWidget()
Supprime l'QPrintPreviewWidget.
int QPrintPreviewWidget::currentPage() const
Renvoie la page actuellement affichée dans l'aperçu.
Voir aussi setCurrentPage().
[slot] void QPrintPreviewWidget::fitInView()
Il s'agit d'une fonction pratique qui équivaut à appeler ` setZoomMode(QPrintPreviewWidget::FitInView)`.
[slot] void QPrintPreviewWidget::fitToWidth()
Il s'agit d'une fonction de commodité qui revient à appeler ` setZoomMode(QPrintPreviewWidget::FitToWidth)`.
QPageLayout::Orientation QPrintPreviewWidget::orientation() const
Renvoie l'orientation actuelle de l'aperçu. Cette valeur est obtenue à partir de l'objet ` QPrinter ` associé à l'aperçu.
Voir aussi setOrientation().
int QPrintPreviewWidget::pageCount() const
Renvoie le nombre de pages de l'aperçu.
[signal] void QPrintPreviewWidget::paintRequested(QPrinter *printer)
Ce signal est émis lorsque le widget de prévisualisation doit générer un ensemble de pages de prévisualisation. ` printer ` est l'imprimante associée à ce widget de prévisualisation.
[signal] void QPrintPreviewWidget::previewChanged()
Ce signal est émis chaque fois que le widget de prévisualisation modifie un état interne, tel que son orientation.
[slot] void QPrintPreviewWidget::print()
Imprime l'aperçu sur l'imprimante associée à cet aperçu.
[slot] void QPrintPreviewWidget::setAllPagesViewMode()
Il s'agit d'une fonction pratique qui revient à appeler setViewMode(QPrintPreviewWidget::AllPagesView).
[slot] void QPrintPreviewWidget::setCurrentPage(int page)
Définit la page actuelle dans l'aperçu. Cela fera passer l'affichage au début de page.
Voir également currentPage().
[slot] void QPrintPreviewWidget::setFacingPagesViewMode()
Il s'agit d'une fonction pratique qui revient à appeler ` setViewMode(QPrintPreviewWidget::FacingPagesView)`.
[slot] void QPrintPreviewWidget::setLandscapeOrientation()
Il s'agit d'une fonction pratique qui revient à appeler ` setOrientation(QPageLayout::Landscape)`.
[slot] void QPrintPreviewWidget::setOrientation(QPageLayout::Orientation orientation)
Définit l'orientation actuelle sur « orientation ». Cette valeur sera appliquée à l'objet « QPrinter » associé à l'aperçu.
Voir également orientation().
[slot] void QPrintPreviewWidget::setPortraitOrientation()
Il s'agit d'une fonction pratique qui équivaut à appeler ` setOrientation(QPageLayout::Portrait)`.
[slot] void QPrintPreviewWidget::setSinglePageViewMode()
Il s'agit d'une fonction pratique qui revient à appeler setViewMode(QPrintPreviewWidget::SinglePageView).
[slot] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)
Définit le mode d'affichage sur « mode ». Le mode d'affichage par défaut est « SinglePageView ».
Voir également viewMode().
[override virtual] void QPrintPreviewWidget::setVisible(bool visible)
[slot] void QPrintPreviewWidget::setZoomFactor(qreal factor)
Définit le facteur de zoom de la vue sur factor. Par exemple, une valeur de 1,0 correspond à une vue non mise à l'échelle, c'est-à-dire à peu près la taille que la vue aura sur papier. Une valeur de 0,5 réduira de moitié la taille de la vue, tandis qu'une valeur de 2,0 la doublera.
Voir aussi zoomFactor().
[slot] void QPrintPreviewWidget::setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)
Définit le mode de zoom sur « zoomMode ». Le mode de zoom par défaut est « FitInView ».
Voir également zoomMode(), viewMode() et setViewMode().
[slot] void QPrintPreviewWidget::updatePreview()
Cette fonction met à jour l'aperçu, ce qui provoque l'émission du signal paintRequested().
QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const
Renvoie le mode d'affichage actuel. Le mode d'affichage par défaut est « SinglePageView ».
Voir aussi setViewMode().
qreal QPrintPreviewWidget::zoomFactor() const
Renvoie le facteur de zoom de la vue.
Voir aussi setZoomFactor().
[slot] void QPrintPreviewWidget::zoomIn(qreal factor = 1.1)
Agrandit la vue actuelle d'factor. La valeur par défaut de factor est 1,1, ce qui signifie que la vue sera agrandie de 10 %.
QPrintPreviewWidget::ZoomMode QPrintPreviewWidget::zoomMode() const
Renvoie le mode de zoom actuel.
Voir également setZoomMode(), viewMode() et setViewMode().
[slot] void QPrintPreviewWidget::zoomOut(qreal factor = 1.1)
Réduit le zoom de la vue actuelle d'un facteur de factor. La valeur par défaut de factor est 1,1, ce qui signifie que la vue sera réduite de 10 %.
© 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.
