QPrintPreviewDialog Class
La classe QPrintPreviewDialog fournit une boîte de dialogue permettant de prévisualiser et de configurer les mises en page pour l'impression. Plus d'informations...
| En-tête : | #include <QPrintPreviewDialog> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS PrintSupport)target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake : | QT += printsupport |
| Héritages : | QDialog |
- Liste de tous les membres, y compris les membres hérités
- QPrintPreviewDialog fait partie des Dialogues standard et des API Imprimante et Impression.
Fonctions publiques
| QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| virtual | ~QPrintPreviewDialog() |
| void | open(QObject *receiver, const char *member) |
| QPrinter * | printer() |
Fonctions publiques réimplémentées
| virtual void | done(int result) override |
| virtual void | setVisible(bool visible) override |
Signaux
| void | paintRequested(QPrinter *printer) |
Description détaillée
L'utilisation de QPrintPreviewDialog dans votre application existante est simple :
- Créez le QPrintPreviewDialog.
Vous pouvez construire un QPrintPreviewDialog avec un objet QPrinter existant, ou vous pouvez demander à QPrintPreviewDialog d'en créer un pour vous, qui sera l'imprimante par défaut du système.
- Connectez le signal paintRequested() à une fente.
Lorsque la boîte de dialogue doit générer un ensemble de pages de prévisualisation, le signal paintRequested() est émis. Vous pouvez utiliser exactement le même code pour l'impression réelle que pour la génération de la prévisualisation, y compris l'appel à QPrinter::newPage() pour commencer une nouvelle page dans la prévisualisation. Connectez un slot au signal paintRequested(), où vous dessinez sur l'objet QPrinter qui est passé dans le slot.
- Appelez exec().
Appelez QPrintPreviewDialog::exec() pour afficher la boîte de dialogue de prévisualisation.
Voir également QPrinter, QPrintDialog, QPageSetupDialog, et QPrintPreviewWidget.
Documentation des fonctions membres
[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Construit un QPrintPreviewDialog basé sur printer et avec parent comme widget parent. Les drapeaux du widget flags sont transmis au constructeur QWidget.
Voir aussi QWidget::setWindowFlags().
[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Cette fonction crée un objet interne QPrinter qui utilise l'imprimante par défaut du système.
Il s'agit d'une fonction surchargée.
[virtual noexcept] QPrintPreviewDialog::~QPrintPreviewDialog()
Détruit le site QPrintPreviewDialog.
[override virtual] void QPrintPreviewDialog::done(int result)
Réimplémente : QDialog::done(int r).
void QPrintPreviewDialog::open(QObject *receiver, const char *member)
Ouvre la boîte de dialogue et connecte son signal finished(int) au slot spécifié par receiver et member.
Le signal sera déconnecté du slot lorsque la boîte de dialogue sera fermée.
[signal] void QPrintPreviewDialog::paintRequested(QPrinter *printer)
Ce signal est émis lorsque le site QPrintPreviewDialog doit générer un ensemble de pages de prévisualisation.
L'instance printer fournie est le dispositif de peinture sur lequel vous devez peindre le contenu de chaque page, en utilisant l'instance QPrinter de la même manière que vous le feriez pour une impression directe.
QPrinter *QPrintPreviewDialog::printer()
Renvoie un pointeur sur l'objet QPrinter sur lequel le dialogue est en cours.
[override virtual] void QPrintPreviewDialog::setVisible(bool visible)
Réimplémente : QDialog::setVisible(bool visible).
© 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.
