QPrintDialog Class
La classe QPrintDialog fournit une boîte de dialogue permettant de définir la configuration de l'imprimante. En savoir plus...
| En-tête : | #include <QPrintDialog> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake : | QT += printsupport |
| Hérite de : | QAbstractPrintDialog |
- Liste de tous les membres, y compris les membres hérités
- QPrintDialog fait partie des boîtes de dialogue standard et des API d'impression.
Propriétés
- options : PrintDialogOptions
Fonctions publiques
| QPrintDialog(QWidget *parent = nullptr) | |
| QPrintDialog(QPrinter *printer, QWidget *parent = nullptr) | |
| virtual | ~QPrintDialog() |
| void | open(QObject *receiver, const char *member) |
| QAbstractPrintDialog::PrintDialogOptions | options() const |
| QPrinter * | printer() |
| void | setOption(QAbstractPrintDialog::PrintDialogOption option, bool on = true) |
| void | setOptions(QAbstractPrintDialog::PrintDialogOptions options) |
| bool | testOption(QAbstractPrintDialog::PrintDialogOption option) const |
Fonctions publiques réimplémentées
| virtual void | done(int result) override |
| virtual int | exec() override |
| virtual void | setVisible(bool visible) override |
Signaux
| void | accepted(QPrinter *printer) |
Description détaillée
La boîte de dialogue permet aux utilisateurs de modifier les paramètres relatifs au document, tels que le format et l'orientation du papier, le type d'impression (couleur ou niveaux de gris), la plage de pages et le nombre de copies à imprimer.
Des commandes permettent également aux utilisateurs de choisir parmi les imprimantes disponibles, y compris les imprimantes réseau configurées.
En règle générale, les objets QPrintDialog sont créés à l’aide d’un objet QPrinter, puis exécutés via la fonction exec().
QPrintDialog printDialog(printer, parent);
if (printDialog.exec() == QDialog::Accepted) {
// print ...
}Si la boîte de dialogue est acceptée par l’utilisateur, l’objet ` QPrinter ` est correctement configuré pour l’impression.
 |  |
La boîte de dialogue d’impression (illustrée ci-dessus dans le style Plastique) permet d’accéder aux propriétés d’impression courantes. Sur les plateformes X11 utilisant le système d’impression CUPS, les paramètres de chaque imprimante disponible peuvent être modifiés via le bouton « Properties » de la boîte de dialogue.
Sous Windows et macOS, la boîte de dialogue d’impression native est utilisée, ce qui signifie que certaines propriétés d’ QWidget et d’ QDialog définies dans la boîte de dialogue ne seront pas respectées. La boîte de dialogue d’impression native sous macOS ne prend pas en charge la configuration des options d’impression ; ainsi, les méthodes setOptions() et setOption() n’ont aucun effet.
Dans Qt 4.4, il était possible d’utiliser les fonctions statiques pour afficher une feuille sur macOS. Cette fonctionnalité n’est plus prise en charge dans Qt 4.5. Si vous souhaitez bénéficier de cette fonctionnalité, utilisez QPrintDialog::open().
Voir également QPageSetupDialog et QPrinter.
Documentation sur les propriétés
options : PrintDialogOptions
Cette propriété regroupe les différentes options qui influencent l'apparence et le comportement de la boîte de dialogue
Par défaut, toutes les options sont désactivées.
Les options doivent être définies avant l'affichage de la boîte de dialogue. Leur définition alors que la boîte de dialogue est visible ne garantit pas un effet immédiat sur celle-ci (selon l'option et la plate-forme).
Fonctions d'accès :
| QAbstractPrintDialog::PrintDialogOptions | options() const |
| void | setOptions(QAbstractPrintDialog::PrintDialogOptions options) |
Voir également setOption() et testOption().
Documentation des fonctions membres
[explicit] QPrintDialog::QPrintDialog(QWidget *parent = nullptr)
Affiche une boîte de dialogue d'impression avec l'parent ion indiquée.
[explicit] QPrintDialog::QPrintDialog(QPrinter *printer, QWidget *parent = nullptr)
Crée une nouvelle boîte de dialogue modale d'impression pour l'printer on spécifiée, avec l'parent on indiquée.
[virtual noexcept] QPrintDialog::~QPrintDialog()
Ferme la boîte de dialogue d'impression.
[signal] void QPrintDialog::accepted(QPrinter *printer)
Ce signal est émis lorsque l'utilisateur valide les valeurs définies dans la boîte de dialogue d'impression. Le paramètre « printer » indique l'imprimante à laquelle ces paramètres ont été appliqués.
[override virtual] void QPrintDialog::done(int result)
Réimplémente : QDialog::done(int r).
Ferme la boîte de dialogue et définit son code de résultat sur result. Si cette boîte de dialogue est affichée à l'aide de exec(), la fonction done() provoque la fin de la boucle d'événements locale, et exec() renvoie result.
Remarque : cette fonction ne s’applique pas à la boîte de dialogue d’impression native sur les plateformes Mac macOS et Windows, car celle-ci doit être modale et seul l’utilisateur peut la fermer.
Voir également QDialog::done().
[override virtual] int QPrintDialog::exec()
Réimplémente : QDialog::exec().
void QPrintDialog::open(QObject *receiver, const char *member)
Ouvre la boîte de dialogue et relie son signal « accepted() » au slot spécifié par « receiver » et « member ».
Le signal sera déconnecté du slot lorsque la boîte de dialogue sera fermée.
QPrinter *QPrintDialog::printer()
Renvoie l'imprimante sur laquelle s'applique cette boîte de dialogue d'impression. Cela peut s'avérer utile lors de l'utilisation de la méthode QPrintDialog::open().
void QPrintDialog::setOption(QAbstractPrintDialog::PrintDialogOption option, bool on = true)
Active l'option spécifiée si on est vrai ; sinon, désactive l'option spécifiée.
Voir également options et testOption().
[override virtual] void QPrintDialog::setVisible(bool visible)
Réimplémente : QDialog::setVisible(bool visible).
bool QPrintDialog::testOption(QAbstractPrintDialog::PrintDialogOption option) const
Renvoie « true » si l'option spécifiée est activée ; sinon, renvoie « false ».
© 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.
