QPagedPaintDevice Class
Die Klasse „QPagedPaintDevice“ stellt ein Zeichen-Gerät dar, das mehrere Seiten unterstützt. Mehr...
| Header: | #include <QPagedPaintDevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QPaintDevice |
| Vererbt an: | QPdfWriter und QPrinter |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPagedPaintDevice ist Teil der Malklassen.
Öffentliche Typen
| enum | PdfVersion { PdfVersion_1_4, PdfVersion_A1b, PdfVersion_1_6, PdfVersion_X4 } |
Öffentliche Funktionen
| virtual | ~QPagedPaintDevice() |
| virtual bool | newPage() = 0 |
| QPageLayout | pageLayout() const |
(since 6.0) QPageRanges | pageRanges() const |
| virtual bool | setPageLayout(const QPageLayout &newPageLayout) |
| virtual bool | setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter) |
| virtual bool | setPageOrientation(QPageLayout::Orientation orientation) |
(since 6.0) virtual void | setPageRanges(const QPageRanges &ranges) |
| virtual bool | setPageSize(const QPageSize &pageSize) |
Ausführliche Beschreibung
Paged-Paint-Geräte werden verwendet, um Ausgaben für den Druck oder für Formate wie PDF zu generieren. „ QPdfWriter “ und „ QPrinter “ erben von dieser Klasse.
Dokumentation zu den Mitgliedstypen
enum QPagedPaintDevice::PdfVersion
Die Enumeration „PdfVersion“ beschreibt die Version der PDF-Datei, die von QPrinter oder QPdfWriter erstellt wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPagedPaintDevice::PdfVersion_1_4 | 0 | Es wird ein PDF 1.4-kompatibles Dokument erstellt. |
QPagedPaintDevice::PdfVersion_A1b | 1 | Es wird ein PDF/A-1b-kompatibles Dokument erstellt. |
QPagedPaintDevice::PdfVersion_1_6 | 2 | Es wird ein PDF 1.6-kompatibles Dokument erstellt. Dieser Wert wurde in Qt 5.12 hinzugefügt. |
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8) | 3 | Es wird ein PDF/X-4-kompatibles Dokument erstellt. |
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QPagedPaintDevice::~QPagedPaintDevice()
Löscht das Objekt.
[pure virtual] bool QPagedPaintDevice::newPage()
Eröffnet eine neue Seite. Gibt bei Erfolg „ true “ zurück.
QPageLayout QPagedPaintDevice::pageLayout() const
Gibt das aktuelle Seitenlayout zurück. Verwenden Sie diese Methode, um auf die aktuellen Methoden „ QPageSize “, „ QPageLayout::Orientation “, „ QMarginsF “, „fullRect()“ und „paintRect()“ zuzugreifen.
Beachten Sie, dass Sie die Setter des zurückgegebenen Objekts nicht verwenden können; Sie müssen entweder die einzelnen Setter von ` QPagedPaintDevice ` aufrufen oder ` setPageLayout()` verwenden.
Siehe auch setPageLayout(), setPageSize(), setPageOrientation() und setPageMargins().
[since 6.0] QPageRanges QPagedPaintDevice::pageRanges() const
Gibt die mit diesem Gerät verknüpften Seitenbereiche zurück.
Diese Funktion wurde in Qt 6.0 eingeführt.
Siehe auch „ setPageRanges()“, „ QPageRanges “, „ QPrinter::fromPage()“ und „ QPrinter::toPage()“.
[virtual] bool QPagedPaintDevice::setPageLayout(const QPageLayout &newPageLayout)
Legt das Seitenlayout auf „ newPageLayout “ fest.
Sie sollten diese Methode aufrufen, bevor Sie „ QPainter::begin()“ aufrufen, oder unmittelbar vor dem Aufruf von „ newPage()“, um das neue Seitenlayout auf eine neue Seite anzuwenden. Sie sollten zwischen dem Aufruf von „setPageLayout()“ und „ newPage()“ keine Zeichnungsmethoden aufrufen, da sonst möglicherweise falsche Zeichnungsmetriken verwendet werden.
Gibt „true“ zurück, wenn das Seitenlayout erfolgreich auf „ newPageLayout “ gesetzt wurde.
Siehe auch ` pageLayout()`.
[virtual] bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter)
Legen Sie die Seiten margins fest, die in der angegebenen Datei „ units “ definiert ist.
Sie sollten diese Funktion vor dem Aufruf von ` QPainter::begin()` oder unmittelbar vor dem Aufruf von ` newPage()` aufrufen, um die neuen Ränder auf eine neue Seite anzuwenden. Zwischen dem Aufruf von `setPageMargins()` und ` newPage()` sollten Sie keine Zeichenmethoden aufrufen, da sonst möglicherweise falsche Zeichenparameter verwendet werden.
Um die aktuellen Seitenränder abzurufen, verwenden Sie ` pageLayout()`. `margins()`.
Gibt „true“ zurück, wenn die Seitenränder erfolgreich auf „ margins “ gesetzt wurden.
Siehe auch ` pageLayout()`.
[virtual] bool QPagedPaintDevice::setPageOrientation(QPageLayout::Orientation orientation)
Legt die Seiten orientation fest.
Die Seitenausrichtung wird verwendet, um die Ausrichtung des Seitenformats beim Abrufen des Seitenrechtecks zu definieren.
Sie sollten diese Methode vor dem Aufruf von ` QPainter::begin()` oder unmittelbar vor dem Aufruf von ` newPage()` aufrufen, um die neue Ausrichtung auf eine neue Seite anzuwenden. Zwischen dem Aufruf von `setPageOrientation()` und ` newPage()` sollten Sie keine Zeichenmethoden aufrufen, da sonst möglicherweise falsche Zeichenmaße verwendet werden.
Um die aktuelle Ausrichtung „ QPageLayout::Orientation “ abzurufen, verwenden Sie ` pageLayout()`.orientation().
Gibt „true“ zurück, wenn die Seitenausrichtung erfolgreich auf „ orientation “ gesetzt wurde.
Siehe auch ` pageLayout()`.
[virtual, since 6.0] void QPagedPaintDevice::setPageRanges(const QPageRanges &ranges)
Legt die Seitenbereiche für dieses Gerät auf „ ranges “ fest.
Diese Funktion wurde in Qt 6.0 eingeführt.
Siehe auch ` pageRanges()`.
[virtual] bool QPagedPaintDevice::setPageSize(const QPageSize &pageSize)
Legt die Seitengröße auf pageSize fest.
Um die aktuelle Seitengröße von „ QPageSize “ abzurufen, verwenden Sie „ pageLayout()“.pageSize().
Sie sollten diese Methode vor dem Aufruf von ` QPainter::begin()` oder unmittelbar vor dem Aufruf von ` newPage()` aufrufen, um die neue Seitengröße auf eine neue Seite anzuwenden. Zwischen dem Aufruf von `setPageSize()` und ` newPage()` sollten Sie keine Zeichenmethoden aufrufen, da sonst möglicherweise falsche Zeichenparameter verwendet werden.
Gibt „true“ zurück, wenn die Seitengröße erfolgreich auf „ pageSize “ festgelegt wurde.
Siehe auch ` pageLayout()`.
© 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.