Sur cette page

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

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 :

  1. 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.

  2. 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.

ConstanteValeurDescription
QPrintPreviewWidget::SinglePageView0Mode d'affichage des pages individuelles de l'aperçu.
QPrintPreviewWidget::FacingPagesView1Mode d'affichage des pages en regard dans l'aperçu.
QPrintPreviewWidget::AllPagesView2Mode 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.

ConstanteValeurDescription
QPrintPreviewWidget::CustomZoom0Le zoom est défini sur une valeur de zoom personnalisée.
QPrintPreviewWidget::FitToWidth1Ce mode adapte la page actuelle à la largeur de la vue.
QPrintPreviewWidget::FitInView2Ce 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.