QPrinterInfo Class
Die Klasse „QPrinterInfo“ ermöglicht den Zugriff auf Informationen zu vorhandenen Druckern. 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 vererbter Mitglieder
- QPrinterInfo ist Teil der Drucker- und Druck-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) |
Ausführliche Beschreibung
Verwenden Sie die statischen Funktionen, um eine Liste von QPrinterInfo-Objekten zu erstellen. Jedes QPrinterInfo-Objekt in der Liste repräsentiert einen einzelnen Drucker und kann nach Name, unterstützten Papierformaten und dem Status als Standarddrucker abgefragt werden.
Dokumentation der Mitgliedsfunktionen
QPrinterInfo::QPrinterInfo()
Erstellt ein leeres QPrinterInfo-Objekt.
Siehe auch „ isNull()“.
[explicit] QPrinterInfo::QPrinterInfo(const QPrinter &printer)
Erstellt ein QPrinterInfo-Objekt aus „ printer “.
QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)
Erstellt eine Kopie von „ other “.
[noexcept] QPrinterInfo::~QPrinterInfo()
Löscht das „ QPrinterInfo “-Objekt. Verweise auf die Werte in diesem Objekt werden ungültig.
[static] QStringList QPrinterInfo::availablePrinterNames()
Gibt eine Liste aller auf diesem System verfügbaren Druckernamen zurück.
Es wird empfohlen, diese Funktion anstelle von ` availablePrinters()` zu verwenden, da sie auf den meisten Systemen schneller ist.
Beachten Sie, dass die Liste veraltet sein kann, wenn Änderungen am lokalen System oder am Remote-Druckserver vorgenommen werden. Instanziieren Sie die erforderlichen ` QPrinterInfo `-Instanzen nur bei Bedarf und überprüfen Sie vor dem Aufruf stets deren Gültigkeit.
[static] QList<QPrinterInfo> QPrinterInfo::availablePrinters()
Gibt eine Liste von „ QPrinterInfo “-Objekten für alle auf diesem System verfügbaren Drucker zurück.
Es wird NICHT empfohlen, diese Funktion zu verwenden, da das Erstellen jeder Druckerinstanz viel Zeit in Anspruch nehmen kann, insbesondere wenn es sich um entfernte Netzwerkdrucker handelt, und da gespeicherte Instanzen veraltet sein können, wenn Änderungen am lokalen System oder am entfernten Druckserver vorgenommen werden. Verwenden Sie stattdessen ` availablePrinterNames()` und instanziieren Sie Druckerinstanzen nur bei Bedarf.
QPrinter::ColorMode QPrinterInfo::defaultColorMode() const
Gibt den Standardfarbmodus dieses Druckers zurück.
QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const
Gibt den Standard-Duplexmodus dieses Druckers zurück.
QPageSize QPrinterInfo::defaultPageSize() const
Gibt die aktuelle Standard-Seitengröße für diesen Drucker zurück.
[static] QPrinterInfo QPrinterInfo::defaultPrinter()
Gibt den Standarddrucker des Systems zurück.
Der Rückgabewert sollte vor der Verwendung mit ` isNull()` überprüft werden, für den Fall, dass kein Standarddrucker vorhanden ist.
Auf einigen Systemen kann es vorkommen, dass zwar Drucker verfügbar sind, aber keiner davon als Standarddrucker festgelegt ist.
Siehe auch ` isNull()`, ` isDefault()` und ` availablePrinters()`.
[static] QString QPrinterInfo::defaultPrinterName()
Gibt den Namen des aktuellen Standarddruckers zurück.
QString QPrinterInfo::description() const
Gibt die für Menschen lesbare Beschreibung des Druckers zurück.
Siehe auch „ QPrinterInfo::printerName()“.
bool QPrinterInfo::isDefault() const
Gibt zurück, ob dieser Drucker derzeit als Standarddrucker festgelegt ist.
bool QPrinterInfo::isNull() const
Gibt zurück, ob dieses „ QPrinterInfo “-Objekt eine Druckerdefinition enthält.
Ein leeres ` QPrinterInfo `-Objekt kann beispielsweise entstehen, wenn ` defaultPrinter()` aufgerufen wird, während sich keine Drucker auf dem System befinden.
bool QPrinterInfo::isRemote() const
Gibt zurück, ob es sich bei diesem Drucker um einen Remote-Netzwerkdrucker handelt.
QString QPrinterInfo::location() const
Gibt den für Menschen lesbaren Standort des Druckers zurück.
QString QPrinterInfo::makeAndModel() const
Gibt die für Menschen lesbare Marke und das Modell des Druckers 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 kleinste von diesem Drucker unterstützte physische Seitengröße zurück.
Siehe auch „ maximumPhysicalPageSize()“.
[static] QPrinterInfo QPrinterInfo::printerInfo(const QString &printerName)
Gibt die Drucker- printerName zurück.
Der Rückgabewert sollte vor der Verwendung mit ` isNull()` überprüft werden, für den Fall, dass der angegebene Drucker nicht existiert.
Siehe auch ` isNull()`.
QString QPrinterInfo::printerName() const
Gibt den Namen des Druckers zurück.
Dies ist eine eindeutige Kennung zur Identifizierung des Druckers, die möglicherweise nicht für Menschen lesbar ist.
Siehe auch ` QPrinterInfo::description()` und ` QPrinter::setPrinterName()`.
QPrinter::PrinterState QPrinterInfo::state() const
Gibt den aktuellen Status dieses Druckers zurück.
Dieser Status ist je nach Plattform, Druckertreiber oder Drucker selbst möglicherweise nicht immer korrekt.
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 Duplexmodi 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 Seitenformate unterstützt.
QPrinterInfo &QPrinterInfo::operator=(const QPrinterInfo &other)
Setzt das Objekt „ QPrinterInfo “ so, dass es mit „ other “ übereinstimmt.
© 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.