QPrinterInfo Class

Die Klasse QPrinterInfo ermöglicht den Zugriff auf Informationen über vorhandene Drucker. Mehr...

Kopfzeile: #include <QPrinterInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport

Öffentliche Funktionen

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)

Statische öffentliche Mitglieder

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

Detaillierte Beschreibung

Verwenden Sie die statischen Funktionen, um eine Liste von QPrinterInfo-Objekten zu erzeugen. Jedes QPrinterInfo-Objekt in der Liste repräsentiert einen einzelnen Drucker und kann nach dem Namen, den unterstützten Papierformaten und danach, ob es sich um den Standarddrucker handelt oder nicht, abgefragt werden.

Dokumentation der Mitgliedsfunktionen

QPrinterInfo::QPrinterInfo()

Konstruiert ein leeres QPrinterInfo-Objekt.

Siehe auch isNull().

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

Konstruiert ein QPrinterInfo-Objekt aus printer.

QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)

Konstruiert eine Kopie von other.

[noexcept] QPrinterInfo::~QPrinterInfo()

Zerstört das Objekt QPrinterInfo. Verweise auf die Werte des Objekts werden ungültig.

[static] QStringList QPrinterInfo::availablePrinterNames()

Gibt eine Liste aller verfügbaren Druckernamen auf diesem System zurück.

Es wird empfohlen, dies anstelle von availablePrinters() zu verwenden, da es auf den meisten Systemen schneller ist.

Beachten Sie, dass die Liste veraltet sein kann, wenn Änderungen auf dem lokalen System oder dem entfernten Druckserver vorgenommen werden. Instanzieren Sie die erforderlichen QPrinterInfo Instanzen nur bei Bedarf und prüfen Sie vor dem Aufruf immer auf Gültigkeit.

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

Gibt eine Liste von QPrinterInfo Objekten für alle verfügbaren Drucker auf diesem System zurück.

Es wird NICHT empfohlen, dies zu verwenden, da die Erstellung jeder Druckerinstanz sehr lange dauern kann, insbesondere wenn es entfernte Netzwerkdrucker gibt, und die beibehaltenen Instanzen veraltet sein können, wenn Änderungen auf dem lokalen System oder dem entfernten Druckserver vorgenommen werden. Verwenden Sie stattdessen availablePrinterNames() und instanziieren Sie Druckerinstanzen nur, wenn Sie sie benötigen.

QPrinter::ColorMode QPrinterInfo::defaultColorMode() const

Gibt den Standardfarbmodus des Druckers zurück.

QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const

Gibt den Standard-Duplexmodus des Druckers zurück.

QPageSize QPrinterInfo::defaultPageSize() const

Gibt die aktuelle Standardseitengröße für diesen Drucker zurück.

[static] QPrinterInfo QPrinterInfo::defaultPrinter()

Gibt den Standarddrucker des Systems zurück.

Der Rückgabewert sollte mit isNull() überprüft werden, bevor er verwendet wird, falls es keinen Standarddrucker gibt.

Auf manchen Systemen ist es möglich, dass es zwar verfügbare Drucker gibt, aber keiner von ihnen als Standarddrucker eingestellt ist.

Siehe auch isNull(), isDefault(), und availablePrinters().

[static] QString QPrinterInfo::defaultPrinterName()

Gibt den aktuellen Standarddruckernamen zurück.

QString QPrinterInfo::description() const

Gibt die menschenlesbare Beschreibung des Druckers zurück.

Siehe auch QPrinterInfo::printerName().

bool QPrinterInfo::isDefault() const

Gibt zurück, ob dieser Drucker derzeit der Standarddrucker ist.

bool QPrinterInfo::isNull() const

Gibt zurück, ob dieses QPrinterInfo Objekt eine Druckerdefinition enthält.

Ein leeres QPrinterInfo -Objekt könnte zum Beispiel durch den Aufruf von defaultPrinter() entstehen, wenn keine Drucker im System vorhanden sind.

bool QPrinterInfo::isRemote() const

Gibt zurück, ob dieser Drucker ein entfernter Netzwerkdrucker ist.

QString QPrinterInfo::location() const

Gibt den für Menschen lesbaren Standort des Druckers zurück.

QString QPrinterInfo::makeAndModel() const

Gibt die Marke und das Modell des Druckers in Klarschrift zurück.

QPageSize QPrinterInfo::maximumPhysicalPageSize() const

Gibt die maximale physische Seitengröße zurück, die von diesem Drucker unterstützt wird.

Siehe auch minimumPhysicalPageSize().

QPageSize QPrinterInfo::minimumPhysicalPageSize() const

Gibt die minimale physische Seitengröße zurück, die von diesem Drucker unterstützt wird.

Siehe auch maximumPhysicalPageSize().

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

Gibt den Drucker printerName zurück.

Der Rückgabewert sollte mit isNull() überprüft werden, bevor er verwendet wird, falls der genannte Drucker nicht existiert.

Siehe auch isNull().

QString QPrinterInfo::printerName() const

Gibt den Namen des Druckers zurück.

Dabei handelt es sich um eine eindeutige ID zur Identifizierung des Druckers, die möglicherweise nicht von Menschen lesbar ist.

Siehe auch QPrinterInfo::description() und QPrinter::setPrinterName().

QPrinter::PrinterState QPrinterInfo::state() const

Gibt den aktuellen Status des Druckers zurück.

Dieser Status ist je nach Plattform, Druckertreiber oder Drucker selbst nicht immer genau.

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

Gibt die von diesem Drucker unterstützten Farbmodi zurück.

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

Gibt eine Liste der von diesem Drucker unterstützten Duplex-Modi zurück.

QList<QPageSize> QPrinterInfo::supportedPageSizes() const

Gibt eine Liste der von diesem Drucker unterstützten Seitenformate zurück.

QList<int> QPrinterInfo::supportedResolutions() const

Gibt eine Liste der von diesem Drucker unterstützten Auflösungen zurück.

bool QPrinterInfo::supportsCustomPageSizes() const

Gibt zurück, ob dieser Drucker benutzerdefinierte Seitengrößen unterstützt.

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

Setzt das Objekt QPrinterInfo auf den Wert other.

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