QPrintEngine Class
Die Klasse „QPrintEngine“ definiert eine Schnittstelle, über die „ QPrinter “ mit einem bestimmten Drucksubsystem interagiert. Mehr...
| Header: | #include <QPrintEngine> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPrintEngine ist Teil der Drucker- und Druck-APIs.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Typen
| enum | PrintEnginePropertyKey { PPK_CollateCopies, PPK_ColorMode, PPK_Creator, PPK_Duplex, PPK_DocumentName, …, PPK_CustomBase } |
Öffentliche Funktionen
| virtual | ~QPrintEngine() |
| virtual bool | abort() = 0 |
| virtual int | metric(QPaintDevice::PaintDeviceMetric id) const = 0 |
| virtual bool | newPage() = 0 |
| virtual QPrinter::PrinterState | printerState() const = 0 |
| virtual QVariant | property(QPrintEngine::PrintEnginePropertyKey key) const = 0 |
| virtual void | setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value) = 0 |
Ausführliche Beschreibung
Beim Erstellen einer eigenen Druck-Engine ist es üblich, sowohl von „ QPaintEngine “ als auch von „QPrintEngine“ abzuleiten. Verschiedene Eigenschaften einer Druck-Engine werden mit „ property()“ abgerufen und mit „ setProperty()“ festgelegt.
Siehe auch „ QPaintEngine “.
Dokumentation zu Mitgliedstypen
enum QPrintEngine::PrintEnginePropertyKey
Diese Enumeration dient zur Übertragung von Eigenschaften zwischen der Druck-Engine und QPrinter. Eine Eigenschaft wird von einer bestimmten Druck-Engine möglicherweise unterstützt, möglicherweise aber auch nicht.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPrintEngine::PPK_CollateCopies | 0 | Ein boolescher Wert, der angibt, ob der Ausdruck sortiert werden soll oder nicht. |
QPrintEngine::PPK_ColorMode | 1 | Bezieht sich auf QPrinter::ColorMode, entweder in Farbe oder schwarz-weiß. |
QPrintEngine::PPK_Creator | 2 | Eine Zeichenkette, die den Ersteller des Dokuments beschreibt. |
QPrintEngine::PPK_Duplex | 20 | Ein boolescher Wert, der angibt, ob beide Seiten des Druckpapiers für den Ausdruck verwendet werden sollen. |
QPrintEngine::PPK_DocumentName | 3 | Eine Zeichenfolge, die den Dokumentnamen im Spooler beschreibt. |
QPrintEngine::PPK_FontEmbedding | 19 | Ein boolescher Wert, der angibt, ob die Daten für die Schriftarten des Dokuments in die an den Drucker gesendeten Daten eingebettet werden sollen. |
QPrintEngine::PPK_FullPage | 4 | Ein boolescher Wert, der angibt, ob der Drucker im Ganzseitenmodus arbeiten soll oder nicht. |
QPrintEngine::PPK_NumberOfCopies | 5 | Veraltet. Eine Ganzzahl, die die Anzahl der Kopien angibt. Verwenden Sie stattdessen PPK_CopyCount. |
QPrintEngine::PPK_Orientation | 6 | Gibt einen Wert für „ QPageLayout::Orientation “ an. |
QPrintEngine::PPK_OutputFileName | 7 | Der Name der Ausgabedatei als Zeichenfolge. Ein leerer Dateiname bedeutet, dass der Drucker nicht in eine Datei drucken soll. |
QPrintEngine::PPK_PageOrder | 8 | Gibt einen „ QPrinter::PageOrder “-Wert an. |
QPrintEngine::PPK_PageRect | 9 | Ein „ QRect “, der das Seitenrechteck angibt |
QPrintEngine::PPK_PageSize | 10 | Veraltet. Verwenden Sie stattdessen PPK_PaperSize. |
QPrintEngine::PPK_PaperRect | 11 | Ein „ QRect “, der das Papierrechteck angibt. |
QPrintEngine::PPK_PaperSource | 12 | Gibt einen Wert für „ QPrinter::PaperSource “ an. |
QPrintEngine::PPK_PaperSources | 21 | Gibt mehr als einen Wert für „ QPrinter::PaperSource “ an. |
QPrintEngine::PPK_PaperName | 26 | Eine Zeichenkette, die den Namen des Papiers angibt. |
QPrintEngine::PPK_PaperSize | PPK_PageSize | Gibt einen QPrinter::PaperSize-Wert an. |
QPrintEngine::PPK_PrinterName | 13 | Eine Zeichenkette, die den Namen des Druckers angibt. |
QPrintEngine::PPK_PrinterProgram | 14 | Eine Zeichenfolge, die den Namen des zum Drucken verwendeten Druckerprogramms angibt, |
QPrintEngine::PPK_Resolution | 15 | Eine Ganzzahl, die die Punktdichte pro Zoll für diesen Drucker angibt. |
QPrintEngine::PPK_SelectionOption | 16 | |
QPrintEngine::PPK_SupportedResolutions | 17 | Eine Liste von QVariants vom Typ „Integer“, die die vom Drucker unterstützten Auflösungen beschreiben. |
QPrintEngine::PPK_WindowsPageSize | 18 | Eine Ganzzahl, die unter Windows einen DM_PAPER-Eintrag angibt. |
QPrintEngine::PPK_CustomPaperSize | 22 | Ein „ QSizeF “, der ein benutzerdefiniertes Papierformat in der Einheit „ QPrinter::Point “ angibt. |
QPrintEngine::PPK_PageMargins | 23 | Ein „ QList “ <QVariant>, der die Werte für den linken, oberen, rechten und unteren Rand in der Einheit „ QPrinter::Point “ enthält. |
QPrintEngine::PPK_CopyCount | 24 | Eine ganze Zahl, die die Anzahl der zu druckenden Kopien angibt. |
QPrintEngine::PPK_SupportsMultipleCopies | 25 | Ein boolescher Wert, der angibt, ob der Drucker den Druck mehrerer Kopien in einem Auftrag unterstützt. |
QPrintEngine::PPK_QPageSize | 27 | Legen Sie die Seitengröße mithilfe eines „ QPageSize “-Objekts fest. |
QPrintEngine::PPK_QPageMargins | 28 | Legen Sie die Seitenränder mithilfe eines std::pair aus QMarginsF und QPageLayout::Unit fest. |
QPrintEngine::PPK_QPageLayout | 29 | Legen Sie das Seitenlayout mithilfe eines „ QPageLayout “-Objekts fest. |
QPrintEngine::PPK_CustomBase | 0xff00 | Grundlage für Erweiterungen. |
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QPrintEngine::~QPrintEngine()
Zerstört die Druckmaschine.
[pure virtual] bool QPrintEngine::abort()
Weist die Druck-Engine an, den Druckvorgang abzubrechen. Gibt bei Erfolg „true“ zurück; andernfalls wird „ false “ zurückgegeben.
[pure virtual] int QPrintEngine::metric(QPaintDevice::PaintDeviceMetric id) const
Gibt die Metrik für die angegebene „ id “ zurück.
[pure virtual] bool QPrintEngine::newPage()
Weist die Druck-Engine an, eine neue Seite zu beginnen. Gibt „ true “ zurück, wenn der Drucker die neue Seite erstellen konnte; andernfalls wird „ false “ zurückgegeben.
[pure virtual] QPrinter::PrinterState QPrintEngine::printerState() const
Gibt den aktuellen Status des Druckers zurück, der von der Druck-Engine verwendet wird.
[pure virtual] QVariant QPrintEngine::property(QPrintEngine::PrintEnginePropertyKey key) const
Gibt die durch „ key “ angegebene Eigenschaft der Druck-Engine zurück.
Siehe auch setProperty().
[pure virtual] void QPrintEngine::setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value)
Setzt die durch „ key “ angegebene Eigenschaft der Druck-Engine auf den angegebenen Wert „ value “.
Siehe auch property().
© 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.
