Auf dieser Seite

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

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

KonstanteWertBeschreibung
QPagedPaintDevice::PdfVersion_1_40Es wird ein PDF 1.4-kompatibles Dokument erstellt.
QPagedPaintDevice::PdfVersion_A1b1Es wird ein PDF/A-1b-kompatibles Dokument erstellt.
QPagedPaintDevice::PdfVersion_1_62Es wird ein PDF 1.6-kompatibles Dokument erstellt. Dieser Wert wurde in Qt 5.12 hinzugefügt.
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8)3Es 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.