QPrintPreviewWidget Class
La classe QPrintPreviewWidget fournit un widget permettant de prévisualiser les mises en page pour l'impression. Plus d'informations...
| En-tête : | #include <QPrintPreviewWidget> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS PrintSupport)target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake : | QT += printsupport |
| Héritages : | QWidget |
- Liste de tous les membres, y compris les membres hérités
- QPrintPreviewWidget fait partie de Printer et Printing APIs.
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 |
Emplacements 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 un QPrintPreviewWidget en interne, et le but de QPrintPreviewWidget est de rendre possible l'intégration de la prévisualisation dans d'autres widgets. Il permet également de construire une interface utilisateur différente de celle fournie par défaut avec QPrintPreviewDialog.
L'utilisation de QPrintPreviewWidget est simple :
- Créer le QPrintPreviewWidget
Construisez le QPrintPreviewWidget soit en passant un objet QPrinter existant, soit en demandant à QPrintPreviewWidget de créer un objet QPrinter par défaut.
- Connectez le signal paintRequested() à un slot.
Lorsque le widget doit générer un ensemble de pages de prévisualisation, un signal paintRequested() est émis par le widget. Connectez un slot à ce signal et dessinez sur le site QPrinter passé en paramètre du signal. Appelez QPrinter::newPage(), pour commencer une nouvelle page dans la prévisualisation.
Voir aussi QPrinter, QPrintDialog, QPageSetupDialog, et QPrintPreviewDialog.
Documentation sur les types de membres
enum QPrintPreviewWidget::ViewMode
Cette énumération est utilisée pour décrire le mode d'affichage du widget de prévisualisation.
| Constante | Valeur | Description |
|---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | Mode d'affichage des pages individuelles de l'aperçu. |
QPrintPreviewWidget::FacingPagesView | 1 | Mode d'affichage des pages en regard dans l'aperçu. |
QPrintPreviewWidget::AllPagesView | 2 | Mode de visualisation de toutes les pages de l'aperçu. |
enum QPrintPreviewWidget::ZoomMode
Cette énumération est utilisée pour décrire le mode de zoom du widget de prévisualisation.
| Constante | Valeur | Description |
|---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | Le zoom est défini sur une valeur de zoom personnalisée. |
QPrintPreviewWidget::FitToWidth | 1 | Ce mode adapte la page actuelle à la largeur de la vue. |
QPrintPreviewWidget::FitInView | 2 | Ce mode permet d'ajuster la page actuelle à l'intérieur de la vue. |
Documentation des fonctions membres
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Construit un QPrintPreviewWidget basé sur printer et avec parent comme widget parent. Les drapeaux du widget flags sont transmis au constructeur QWidget.
Voir aussi QWidget::setWindowFlags().
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
QPrintPreviewWidget crée alors un objet QPrinter interne, construit 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()
Détruit le site QPrintPreviewWidget.
int QPrintPreviewWidget::currentPage() const
Renvoie la page actuellement visualisée dans l'aperçu.
Voir aussi setCurrentPage().
[slot] void QPrintPreviewWidget::fitInView()
Il s'agit d'une fonction de commodité qui revient à 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 également 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 lorsque le widget de prévisualisation a changé d'état interne, comme l'orientation.
[slot] void QPrintPreviewWidget::print()
Imprime l'aperçu sur l'imprimante associée à l'aperçu.
[slot] void QPrintPreviewWidget::setAllPagesViewMode()
Il s'agit d'une fonction de commodité qui revient à appeler setViewMode(QPrintPreviewWidget::AllPagesView).
[slot] void QPrintPreviewWidget::setCurrentPage(int page)
Définit la page actuelle dans l'aperçu. L'affichage passe ainsi au début de page.
Voir aussi currentPage().
[slot] void QPrintPreviewWidget::setFacingPagesViewMode()
Il s'agit d'une fonction de commodité qui revient à appeler setViewMode(QPrintPreviewWidget::FacingPagesView).
[slot] void QPrintPreviewWidget::setLandscapeOrientation()
Il s'agit d'une fonction de commodité qui revient à appeler setOrientation(QPageLayout::Landscape).
[slot] void QPrintPreviewWidget::setOrientation(QPageLayout::Orientation orientation)
Définit l'orientation actuelle sur orientation. Cette valeur sera définie sur l'objet QPrinter associé à la prévisualisation.
Voir aussi orientation().
[slot] void QPrintPreviewWidget::setPortraitOrientation()
Il s'agit d'une fonction de commodité qui revient à appeler setOrientation(QPageLayout::Portrait).
[slot] void QPrintPreviewWidget::setSinglePageViewMode()
Il s'agit d'une fonction de commodité qui revient à appeler setViewMode(QPrintPreviewWidget::SinglePageView).
[slot] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)
Définit le mode d'affichage à mode. Le mode d'affichage par défaut est SinglePageView.
Voir aussi 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 indique une vue non mise à l'échelle, ce qui correspond approximativement à la taille de la vue sur papier. Une valeur de 0,5 réduit de moitié la taille de la vue, tandis qu'une valeur de 2,0 double la taille de la vue.
Voir également 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 aussi zoomMode(), viewMode() et setViewMode().
[slot] void QPrintPreviewWidget::updatePreview()
Cette fonction met à jour l'aperçu, ce qui entraîne 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)
Effectue un zoom sur la vue actuelle à l'aide de 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 aussi setZoomMode(), viewMode() et setViewMode().
[slot] void QPrintPreviewWidget::zoomOut(qreal factor = 1.1)
Effectue un zoom arrière sur la vue actuelle en utilisant 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.