QPagedPaintDevice Class

Die Klasse QPagedPaintDevice repräsentiert ein Malgerät, das mehrere Seiten unterstützt. Mehr...

Kopfzeile: #include <QPagedPaintDevice>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Vererbt: QPaintDevice
Vererbt von:

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)

Detaillierte Beschreibung

Paged-Paint-Geräte werden verwendet, um Ausgaben für den Druck oder für Formate wie PDF zu erzeugen. QPdfWriter und QPrinter erben davon.

Dokumentation der Mitgliedstypen

enum QPagedPaintDevice::PdfVersion

Das PdfVersion-Enum beschreibt die Version der PDF-Datei, die von QPrinter oder QPdfWriter erzeugt wird.

KonstanteWertBeschreibung
QPagedPaintDevice::PdfVersion_1_40Es wird ein PDF 1.4-kompatibles Dokument erzeugt.
QPagedPaintDevice::PdfVersion_A1b1Es wird ein PDF/A-1b-kompatibles Dokument erzeugt.
QPagedPaintDevice::PdfVersion_1_62Ein PDF 1.6 kompatibles Dokument wird erzeugt. Dieser Wert wurde in Qt 5.12 hinzugefügt.
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8)3Es wird ein PDF/X-4-kompatibles Dokument erzeugt.

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QPagedPaintDevice::~QPagedPaintDevice()

Zerstört das Objekt.

[pure virtual] bool QPagedPaintDevice::newPage()

Startet 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 QPageSize, QPageLayout::Orientation, QMarginsF, fullRect() und paintRect() zuzugreifen.

Beachten Sie, dass Sie die Setzer für das zurückgegebene Objekt nicht verwenden können. Sie müssen entweder die einzelnen QPagedPaintDevice Setzer aufrufen oder setPageLayout() verwenden.

Siehe auch setPageLayout(), setPageSize(), setPageOrientation(), und setPageMargins().

[since 6.0] QPageRanges QPagedPaintDevice::pageRanges() const

Gibt die mit diesem Gerät verbundenen 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)

Setzt das Seitenlayout auf newPageLayout.

Sie sollten dies vor dem Aufruf von QPainter::begin() oder unmittelbar vor dem Aufruf von newPage() aufrufen, um das neue Seitenlayout auf eine neue Seite anzuwenden. Zwischen einem Aufruf von setPageLayout() und newPage() sollten Sie keine Malmethoden aufrufen, da die falschen Malmetriken verwendet werden könnten.

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)

Setzt die Seite margins, die in der angegebenen units definiert ist.

Sie sollten dies 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 einem Aufruf von setPageMargins() und newPage() sollten Sie keine Malmethoden aufrufen, da sonst die falschen Malmetriken verwendet werden könnten.

Um die aktuellen Seitenränder zu erhalten, 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 Seite orientation fest.

Die Seitenausrichtung wird verwendet, um die Ausrichtung der Seitengröße zu definieren, wenn das Seitenformat abgerufen wird.

Sie sollten dies vor dem Aufruf von QPainter::begin() oder unmittelbar vor dem Aufruf von newPage() aufrufen, um die neue Ausrichtung auf eine neue Seite anzuwenden. Zwischen einem Aufruf von setPageOrientation() und newPage() sollten Sie keine Malmethoden aufrufen, da sonst die falschen Malmetriken verwendet werden könnten.

Um die aktuelle QPageLayout::Orientation zu erhalten, 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)

Setzt die Seitenbereiche für dieses Gerät auf ranges.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch pageRanges().

[virtual] bool QPagedPaintDevice::setPageSize(const QPageSize &pageSize)

Setzt die Seitengröße auf pageSize.

Um die aktuelle QPageSize zu erhalten, verwenden Sie pageLayout().pageSize().

Sie sollten dies 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 einem Aufruf von setPageSize() und newPage() sollten Sie keine Malmethoden aufrufen, da die falschen Malmetriken verwendet werden könnten.

Gibt true zurück, wenn die Seitengröße erfolgreich auf pageSize gesetzt wurde.

Siehe auch pageLayout().

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