QPrintEngine Class
Die Klasse QPrintEngine definiert eine Schnittstelle dafür, wie QPrinter mit einem gegebenen Druck-Subsystem interagiert. Mehr...
| Kopfzeile: | #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 von Printer und Printing APIs.
Hinweis: Alle Funktionen in 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 |
Detaillierte Beschreibung
Der übliche Fall bei der Erstellung einer eigenen Druckmaschine ist die Ableitung sowohl von QPaintEngine als auch von QPrintEngine. Verschiedene Eigenschaften einer Druckmaschine werden mit property() angegeben und mit setProperty() gesetzt.
Siehe auch QPaintEngine.
Member-Typ-Dokumentation
enum QPrintEngine::PrintEnginePropertyKey
Diese Aufzählung wird verwendet, um Eigenschaften zwischen dem Drucksystem und QPrinter zu kommunizieren. Eine Eigenschaft kann von einem bestimmten Drucksystem unterstützt werden oder 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 farbig oder monochrom. |
QPrintEngine::PPK_Creator | 2 | Eine Zeichenfolge, die den Ersteller des Dokuments beschreibt. |
QPrintEngine::PPK_Duplex | 20 | Ein boolescher Wert, der angibt, ob beide Seiten des Druckerpapiers für den Ausdruck verwendet werden sollen. |
QPrintEngine::PPK_DocumentName | 3 | Eine Zeichenkette, die den Namen des Dokuments im Spooler beschreibt. |
QPrintEngine::PPK_FontEmbedding | 19 | Ein boolescher Wert, der angibt, ob 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 ganzseitig sein soll oder nicht. |
QPrintEngine::PPK_NumberOfCopies | 5 | Obsolet. Eine Ganzzahl, die die Anzahl der Kopien angibt. Verwenden Sie stattdessen PPK_CopyCount. |
QPrintEngine::PPK_Orientation | 6 | Gibt einen QPageLayout::Orientation Wert an. |
QPrintEngine::PPK_OutputFileName | 7 | Der Name der Ausgabedatei in Form einer Zeichenkette. 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 | Eine QRect, die 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 QPrinter::PaperSource Wert an. |
QPrintEngine::PPK_PaperSources | 21 | Gibt mehr als einen QPrinter::PaperSource Wert an. |
QPrintEngine::PPK_PaperName | 26 | Ein String, der 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 Zeichenkette, die den Namen des Druckerprogramms angibt, das zum Drucken verwendet wird, |
QPrintEngine::PPK_Resolution | 15 | Eine ganze Zahl, die die Punkte pro Zoll für diesen Drucker beschreibt. |
QPrintEngine::PPK_SelectionOption | 16 | |
QPrintEngine::PPK_SupportedResolutions | 17 | Eine Liste ganzzahliger QVarianten, die den Satz der vom Drucker unterstützten Auflösungen beschreiben. |
QPrintEngine::PPK_WindowsPageSize | 18 | Eine ganze Zahl, die einen DM_PAPER-Eintrag unter Windows angibt. |
QPrintEngine::PPK_CustomPaperSize | 22 | Eine QSizeF, die ein benutzerdefiniertes Papierformat in der Einheit QPrinter::Point angibt. |
QPrintEngine::PPK_PageMargins | 23 | Ein QList<QVariant> mit den Werten für den linken, oberen, rechten und unteren Rand in der Einheit QPrinter::Point. |
QPrintEngine::PPK_CopyCount | 24 | Eine Ganzzahl, 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 oder nicht. |
QPrintEngine::PPK_QPageSize | 27 | Legen Sie die Seitengröße mit einem QPageSize Objekt fest. |
QPrintEngine::PPK_QPageMargins | 28 | Legen Sie die Seitenränder mit Hilfe eines QPair von QMarginsF und QPageLayout::Unit fest. |
QPrintEngine::PPK_QPageLayout | 29 | Legen Sie das Seitenlayout mit Hilfe eines QPageLayout Objekts fest. |
QPrintEngine::PPK_CustomBase | 0xff00 | Grundlage für die Erweiterung. |
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QPrintEngine::~QPrintEngine()
Zerstört das Druckwerk.
[pure virtual] bool QPrintEngine::abort()
Weist das Drucksystem an, den Druckvorgang abzubrechen. Gibt bei Erfolg true zurück, andernfalls false.
[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 das Drucksystem 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 Druckmaschine verwendet wird.
[pure virtual] QVariant QPrintEngine::property(QPrintEngine::PrintEnginePropertyKey key) const
Gibt die durch key angegebene Eigenschaft der Druckmaschine zurück.
Siehe auch setProperty().
[pure virtual] void QPrintEngine::setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value)
Setzt die durch key angegebene Eigenschaft der Druckmaschine auf die angegebene value.
Siehe auch property().
© 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.
