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 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPagedPaintDevice ist Teil der Painting-Klassen.
Ö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.
Konstante | Wert | Beschreibung |
---|---|---|
QPagedPaintDevice::PdfVersion_1_4 | 0 | Es wird ein PDF 1.4-kompatibles Dokument erzeugt. |
QPagedPaintDevice::PdfVersion_A1b | 1 | Es wird ein PDF/A-1b-kompatibles Dokument erzeugt. |
QPagedPaintDevice::PdfVersion_1_6 | 2 | Ein PDF 1.6 kompatibles Dokument wird erzeugt. 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 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.