Sur cette page

QPrinterInfo Class

La classe QPrinterInfo permet d'accéder à des informations sur les imprimantes existantes. En savoir plus...

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 imprimante distincte et permet d’interroger 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()

Crée un objet QPrinterInfo vide.

Voir aussi isNull().

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

Crée un objet `QPrinterInfo` à partir de ` printer`.

QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)

Crée une copie de other.

[noexcept] QPrinterInfo::~QPrinterInfo()

Supprime l'objet ` QPrinterInfo `. Les références aux valeurs contenues dans cet 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 méthode plutôt que ` availablePrinters()` car elle s'avère plus rapide sur la plupart des systèmes.

Notez que la liste peut devenir obsolète si des modifications sont apportées sur le système local ou sur le serveur d'impression distant. N'instanciez les objets ` QPrinterInfo ` que lorsque cela est nécessaire, et vérifiez toujours leur validité avant de les appeler.

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

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

Il n'est PAS recommandé d'utiliser cette méthode, car la création de chaque instance d'imprimante peut prendre beaucoup de temps, en particulier s'il existe des imprimantes distantes en réseau, et les instances conservées peuvent devenir obsolètes si des modifications sont apportées sur le système local ou sur le serveur d'impression distant. Utilisez plutôt la méthode availablePrinterNames() et n'instanciez des imprimantes qu'au fur et à mesure de vos besoins.

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 actuelle pour cette imprimante.

[static] QPrinterInfo QPrinterInfo::defaultPrinter()

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

La valeur renvoyée doit être vérifiée à l'aide de la fonction ` 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 également isNull(), isDefault() et availablePrinters().

[static] QString QPrinterInfo::defaultPrinterName()

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

QString QPrinterInfo::description() const

Renvoie la description lisible par l'utilisateur 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

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

Un objet ` QPrinterInfo ` vide peut par exemple résulter de l'appel à la fonction ` defaultPrinter()` lorsqu'aucune imprimante n'est présente sur le système.

bool QPrinterInfo::isRemote() const

Indique si cette imprimante est une imprimante réseau distante.

QString QPrinterInfo::location() const

Renvoie l'emplacement de l'imprimante sous une forme lisible par l'utilisateur.

QString QPrinterInfo::makeAndModel() const

Renvoie la marque et le modèle de l'imprimante sous une forme lisible par l'utilisateur.

QPageSize QPrinterInfo::maximumPhysicalPageSize() const

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

Voir également minimumPhysicalPageSize().

QPageSize QPrinterInfo::minimumPhysicalPageSize() const

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

Voir également maximumPhysicalPageSize().

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

Renvoie l'printerName de l'imprimante.

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

Voir également ` isNull()`.

QString QPrinterInfo::printerName() const

Renvoie le nom de l'imprimante.

Il s'agit d'un identifiant unique permettant d'identifier l'imprimante ; il n'est pas forcément lisible par l'utilisateur.

Voir également QPrinterInfo::description() et QPrinter::setPrinterName().

QPrinter::PrinterState QPrinterInfo::state() const

Renvoie l'état actuel de cette imprimante.

Cet état peut ne pas toujours être exact, selon la plate-forme, le pilote d'imprimante ou l'imprimante elle-même.

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

Renvoie les modes couleur pris en charge par cette imprimante.

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

Renvoie une liste des modes d'impression 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 » de manière à ce qu'il soit é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.