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 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPrinterInfo ist Teil von Printer und Printing APIs.
Ö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.