Auf dieser Seite

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

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