Sur cette page

QPrinterInfo Class

La classe QPrinterInfo donne accès à des informations sur les imprimantes existantes. Plus d'informations...

En-tête : #include <QPrinterInfo>
CMake : find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake : QT += printsupport

Fonctions publiques

QPrinterInfo()
QPrinterInfo(const QPrinter &printer)
QPrinterInfo(const QPrinterInfo &other)
~QPrinterInfo()
QPrinter::ColorMode defaultColorMode() const
QPrinter::DuplexMode defaultDuplexMode() const
QPageSize defaultPageSize() const
QString description() const
bool isDefault() const
bool isNull() const
bool isRemote() const
QString location() const
QString makeAndModel() const
QPageSize maximumPhysicalPageSize() const
QPageSize minimumPhysicalPageSize() const
QString printerName() const
QPrinter::PrinterState state() const
QList<QPrinter::ColorMode> supportedColorModes() const
QList<QPrinter::DuplexMode> supportedDuplexModes() const
QList<QPageSize> supportedPageSizes() const
QList<int> supportedResolutions() const
bool supportsCustomPageSizes() const
QPrinterInfo &operator=(const QPrinterInfo &other)

Membres publics statiques

QStringList availablePrinterNames()
QList<QPrinterInfo> availablePrinters()
QPrinterInfo defaultPrinter()
QString defaultPrinterName()
QPrinterInfo printerInfo(const QString &printerName)

Description détaillée

Utilisez les fonctions statiques pour générer une liste d'objets QPrinterInfo. Chaque objet QPrinterInfo de la liste représente une seule imprimante et peut être interrogé sur son nom, les formats de papier pris en charge et s'il s'agit ou non de l'imprimante par défaut.

Documentation des fonctions membres

QPrinterInfo::QPrinterInfo()

Construit un objet QPrinterInfo vide.

Voir aussi isNull().

[explicit] QPrinterInfo::QPrinterInfo(const QPrinter &printer)

Construit un objet QPrinterInfo à partir de printer.

QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)

Construit une copie de other.

[noexcept] QPrinterInfo::~QPrinterInfo()

Détruit l'objet QPrinterInfo. Les références aux valeurs de l'objet deviennent invalides.

[static] QStringList QPrinterInfo::availablePrinterNames()

Renvoie une liste de tous les noms d'imprimantes disponibles sur ce système.

Il est recommandé d'utiliser cette fonction au lieu de availablePrinters(), car elle est plus rapide sur la plupart des systèmes.

Notez que la liste peut devenir obsolète si des changements sont effectués sur le système local ou le serveur d'impression distant. N'instanciez les instances de QPrinterInfo qu'en cas de besoin, et vérifiez toujours leur validité avant de les appeler.

[static] QList<QPrinterInfo> QPrinterInfo::availablePrinters()

Renvoie une liste d'objets QPrinterInfo pour toutes les imprimantes disponibles sur ce système.

Il n'est PAS recommandé d'utiliser cette fonction car la création de chaque instance d'imprimante peut prendre beaucoup de temps, surtout s'il y a des imprimantes distantes en réseau, et les instances conservées peuvent devenir obsolètes si des changements sont effectués sur le système local ou le serveur d'impression distant. Utilisez plutôt availablePrinterNames() et n'instanciez les instances d'imprimantes que lorsque vous en avez besoin.

QPrinter::ColorMode QPrinterInfo::defaultColorMode() const

Renvoie le mode couleur par défaut de cette imprimante.

QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const

Renvoie le mode recto-verso par défaut de cette imprimante.

QPageSize QPrinterInfo::defaultPageSize() const

Renvoie la taille de page par défaut pour cette imprimante.

[static] QPrinterInfo QPrinterInfo::defaultPrinter()

Renvoie l'imprimante par défaut du système.

La valeur de retour doit être vérifiée à l'aide de isNull() avant d'être utilisée, au cas où il n'y aurait pas d'imprimante par défaut.

Sur certains systèmes, il est possible qu'il y ait des imprimantes disponibles mais qu'aucune d'entre elles ne soit définie comme imprimante par défaut.

Voir aussi isNull(), isDefault(), et availablePrinters().

[static] QString QPrinterInfo::defaultPrinterName()

Renvoie le nom de l'imprimante par défaut.

QString QPrinterInfo::description() const

Renvoie la description lisible par l'homme de l'imprimante.

Voir aussi QPrinterInfo::printerName().

bool QPrinterInfo::isDefault() const

Indique si cette imprimante est actuellement l'imprimante par défaut.

bool QPrinterInfo::isNull() const

Retourne si cet objet QPrinterInfo contient une définition d'imprimante.

Un objet QPrinterInfo vide peut résulter, par exemple, de l'appel à defaultPrinter() alors qu'il n'y a pas d'imprimante sur le système.

bool QPrinterInfo::isRemote() const

Indique si cette imprimante est une imprimante réseau à distance.

QString QPrinterInfo::location() const

Renvoie l'emplacement lisible par l'homme de l'imprimante.

QString QPrinterInfo::makeAndModel() const

Renvoie la marque et le modèle de l'imprimante, lisibles par l'homme.

QPageSize QPrinterInfo::maximumPhysicalPageSize() const

Renvoie la taille de page physique maximale prise en charge par cette imprimante.

Voir également minimumPhysicalPageSize().

QPageSize QPrinterInfo::minimumPhysicalPageSize() const

Renvoie la taille de page physique minimale prise en charge par cette imprimante.

Voir également maximumPhysicalPageSize().

[static] QPrinterInfo QPrinterInfo::printerInfo(const QString &printerName)

Renvoie l'imprimante printerName.

La valeur de retour doit être vérifiée à l'aide de isNull() avant d'être utilisée, au cas où l'imprimante nommée n'existerait pas.

Voir aussi isNull().

QString QPrinterInfo::printerName() const

Renvoie le nom de l'imprimante.

Il s'agit d'un identifiant unique qui permet d'identifier l'imprimante et qui peut ne pas être lisible par l'homme.

Voir aussi QPrinterInfo::description() et QPrinter::setPrinterName().

QPrinter::PrinterState QPrinterInfo::state() const

Renvoie l'état actuel de cette imprimante.

Cet état n'est pas toujours exact, en fonction de la plate-forme, du pilote d'imprimante ou de l'imprimante elle-même.

QList<QPrinter::ColorMode> QPrinterInfo::supportedColorModes() const

Renvoie les modes de couleur pris en charge par cette imprimante.

QList<QPrinter::DuplexMode> QPrinterInfo::supportedDuplexModes() const

Renvoie une liste des modes recto-verso pris en charge par cette imprimante.

QList<QPageSize> QPrinterInfo::supportedPageSizes() const

Renvoie une liste des formats de page pris en charge par cette imprimante.

QList<int> QPrinterInfo::supportedResolutions() const

Renvoie une liste des résolutions prises en charge par cette imprimante.

bool QPrinterInfo::supportsCustomPageSizes() const

Indique si cette imprimante prend en charge les formats de page personnalisés.

QPrinterInfo &QPrinterInfo::operator=(const QPrinterInfo &other)

Définit l'objet QPrinterInfo comme étant égal à other.

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