QPageSize Class

Die Klasse QPageSize beschreibt die Größe und den Namen einer definierten Seitengröße. Mehr...

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

Öffentliche Typen

enum PageSizeId { A0, A1, A2, A3, A4, …, LastPageSize }
enum SizeMatchPolicy { FuzzyMatch, FuzzyOrientationMatch, ExactMatch }
enum Unit { Millimeter, Point, Inch, Pica, Didot, Cicero }

Öffentliche Funktionen

QPageSize()
QPageSize(QPageSize::PageSizeId pageSize)
QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize(const QPageSize &other)
~QPageSize()
QSizeF definitionSize() const
QPageSize::Unit definitionUnits() const
QPageSize::PageSizeId id() const
bool isEquivalentTo(const QPageSize &other) const
bool isValid() const
QString key() const
QString name() const
QRectF rect(QPageSize::Unit units) const
QRect rectPixels(int resolution) const
QRect rectPoints() const
QSizeF size(QPageSize::Unit units) const
QSize sizePixels(int resolution) const
QSize sizePoints() const
void swap(QPageSize &other)
int windowsId() const
QPageSize &operator=(QPageSize &&other)
QPageSize &operator=(const QPageSize &other)

Statische öffentliche Mitglieder

QSizeF definitionSize(QPageSize::PageSizeId pageSizeId)
QPageSize::Unit definitionUnits(QPageSize::PageSizeId pageSizeId)
QPageSize::PageSizeId id(int windowsId)
QPageSize::PageSizeId id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize::PageSizeId id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QString key(QPageSize::PageSizeId pageSizeId)
QString name(QPageSize::PageSizeId pageSizeId)
QSizeF size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)
QSize sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)
QSize sizePoints(QPageSize::PageSizeId pageSizeId)
int windowsId(QPageSize::PageSizeId pageSizeId)
bool operator!=(const QPageSize &lhs, const QPageSize &rhs)
bool operator==(const QPageSize &lhs, const QPageSize &rhs)

Detaillierte Beschreibung

Diese Klasse implementiert die Unterstützung für den Satz von Standardseitengrößen, wie sie im Adobe Postscript PPD Standard v4.3 definiert sind. Sie definiert den Standardsatz von Seitengrößen in Punkt, Millimeter und Zoll und stellt sicher, dass diese Größen konsistent verwendet werden. Andere Größeneinheiten können zwar verwendet werden, werden aber berechnet und sind daher möglicherweise nicht immer konsistent. Die definierten Punktgrößen sind immer eine ganze Zahl, alle anderen Größen können Bruchteile einer Einheit sein.

Die definierte Größe ist immer in der Reihenfolge Breite x Höhe ohne implizite Seitenausrichtung. Beachten Sie, dass es möglich ist, Seitengrößen zu definieren, bei denen die Breite größer als die Höhe ist, wie z. B. QPageSize::Ledger. Sie können sich also nicht auf den Vergleich der Werte für Breite und Höhe verlassen, um die Seitenausrichtung zu bestimmen.

A4 ist beispielsweise standardmäßig definiert als 210mm x 297mm, 8.27in x 11.69in, oder 595pt x 842pt.

Sie können auch benutzerdefinierte Seitengrößen mit benutzerdefinierten Namen in beliebigen Einheiten definieren, die dann beibehalten und als Basis für alle anderen Größenberechnungen verwendet werden.

Wenn Sie eine QPageSize mit einer benutzerdefinierten QSize erstellen, können Sie wählen, ob QPageSize versuchen soll, die Größe an eine Standardseitengröße anzupassen. Standardmäßig verwendet QPaperSize einen FuzzyMatch Modus, in dem es eine gegebene Seitengröße an eine Standardseitengröße anpasst, wenn sie innerhalb von 3 Postscriptpunkten einer definierten Standardgröße liegt. Sie können dies überschreiben, um nur eine exakte Übereinstimmung anzufordern, aber dies wird nicht empfohlen, da bei der Konvertierung zwischen Einheiten leicht 3 Punkte verloren gehen können und dies zu falschen Seitengrößen führt.

Eine QPageSize-Instanz kann auch durch Abfrage der unterstützten Seitengrößen für ein Druckgerät erhalten werden. In diesem Fall ist der zurückgegebene lokalisierte Name derjenige, der vom Drucker selbst definiert wurde. Beachten Sie, dass das Druckgerät möglicherweise nicht die aktuelle Standard-Locale-Sprache unterstützt.

Die Klasse bietet auch bequeme Methoden zur Konvertierung von Seitengrößen-IDs in und aus verschiedenen Größeneinheiten.

Siehe auch QPagedPaintDevice und QPdfWriter.

Dokumentation der Mitgliedstypen

enum QPageSize::PageSizeId

Dieser Enum-Typ listet die verfügbaren Seitengrößen auf, wie sie im Postscript PPD-Standard definiert sind. Diese Werte werden in QPagedPaintDevice und QPrinter dupliziert.

Die definierten Größen sind:

KonstanteWertBeschreibung
QPageSize::A03841 x 1189 mm
QPageSize::A14594 x 841 mm
QPageSize::A25420 x 594 mm
QPageSize::A36297 x 420 mm
QPageSize::A47210 x 297 mm, 8,26 x 11,69 Zoll
QPageSize::A58148 x 210 mm
QPageSize::A69105 x 148 mm
QPageSize::A71074 x 105 mm
QPageSize::A81152 x 74 mm
QPageSize::A91237 x 52 mm
QPageSize::B0141000 x 1414 mm
QPageSize::B115707 x 1000 mm
QPageSize::B216500 x 707 mm
QPageSize::B317353 x 500 mm
QPageSize::B418250 x 353 mm
QPageSize::B519176 x 250 mm, 6,93 x 9,84 Zoll
QPageSize::B620125 x 176 mm
QPageSize::B72188 x 125 mm
QPageSize::B82262 x 88 mm
QPageSize::B92344 x 62 mm
QPageSize::B102431 x 44 mm
QPageSize::C5E25163 x 229 mm
QPageSize::Comm10E26105 x 241 mm, U.S. Common 10 Umschlag
QPageSize::DLE27110 x 220 mm
QPageSize::Executive27,5 x 10 Zoll, 190,5 x 254 mm
QPageSize::Folio28210 x 330 mm
QPageSize::Ledger29431,8 x 279,4 mm
QPageSize::Legal18,5 x 14 Zoll, 215,9 x 355,6 mm
QPageSize::Letter08,5 x 11 Zoll, 215,9 x 279,4 mm
QPageSize::Tabloid30279,4 x 431,8 mm
QPageSize::Custom31Unbekannt, oder eine benutzerdefinierte Größe.
QPageSize::A1013
QPageSize::A3Extra32
QPageSize::A4Extra33
QPageSize::A4Plus34
QPageSize::A4Small35
QPageSize::A5Extra36
QPageSize::B5Extra37
QPageSize::JisB038
QPageSize::JisB139
QPageSize::JisB240
QPageSize::JisB341
QPageSize::JisB442
QPageSize::JisB543
QPageSize::JisB644,
QPageSize::JisB745
QPageSize::JisB846
QPageSize::JisB947
QPageSize::JisB1048
QPageSize::AnsiALetter= Brief
QPageSize::AnsiBLedger= Ledger
QPageSize::AnsiC49
QPageSize::AnsiD50
QPageSize::AnsiE51
QPageSize::LegalExtra52
QPageSize::LetterExtra53
QPageSize::LetterPlus54
QPageSize::LetterSmall55
QPageSize::TabloidExtra56
QPageSize::ArchA57
QPageSize::ArchB58
QPageSize::ArchC59
QPageSize::ArchD60
QPageSize::ArchE61
QPageSize::Imperial7x962
QPageSize::Imperial8x1063
QPageSize::Imperial9x1164
QPageSize::Imperial9x1265
QPageSize::Imperial10x1166
QPageSize::Imperial10x1367
QPageSize::Imperial10x1468
QPageSize::Imperial12x1169
QPageSize::Imperial15x1170
QPageSize::ExecutiveStandard71
QPageSize::Note72
QPageSize::Quarto73
QPageSize::Statement74
QPageSize::SuperA75
QPageSize::SuperB76
QPageSize::Postcard77
QPageSize::DoublePostcard78
QPageSize::Prc16K79
QPageSize::Prc32K80
QPageSize::Prc32KBig81
QPageSize::FanFoldUS82
QPageSize::FanFoldGerman83
QPageSize::FanFoldGermanLegal84
QPageSize::EnvelopeB485
QPageSize::EnvelopeB586
QPageSize::EnvelopeB687
QPageSize::EnvelopeC088
QPageSize::EnvelopeC189
QPageSize::EnvelopeC290
QPageSize::EnvelopeC391
QPageSize::EnvelopeC492
QPageSize::EnvelopeC5C5E= C5E
QPageSize::EnvelopeC693
QPageSize::EnvelopeC6594
QPageSize::EnvelopeC795
QPageSize::EnvelopeDLDLE= DLE
QPageSize::Envelope996
QPageSize::Envelope10Comm10E= Comm10E
QPageSize::Envelope1197
QPageSize::Envelope1298
QPageSize::Envelope1499
QPageSize::EnvelopeMonarch100
QPageSize::EnvelopePersonal101
QPageSize::EnvelopeChou3102
QPageSize::EnvelopeChou4103
QPageSize::EnvelopeInvite104
QPageSize::EnvelopeItalian105
QPageSize::EnvelopeKaku2106
QPageSize::EnvelopeKaku3107
QPageSize::EnvelopePrc1108
QPageSize::EnvelopePrc2109
QPageSize::EnvelopePrc3110
QPageSize::EnvelopePrc4111
QPageSize::EnvelopePrc5112
QPageSize::EnvelopePrc6113
QPageSize::EnvelopePrc7114
QPageSize::EnvelopePrc8115
QPageSize::EnvelopePrc9116
QPageSize::EnvelopePrc10117
QPageSize::EnvelopeYou4118
QPageSize::LastPageSizeEnvelopeYou4= EnvelopeYou4

Aus historischen Gründen entspricht QPageSize::Executive nicht der Standardgröße für Postscript und Windows Executive, verwenden Sie stattdessen QPageSize::ExecutiveStandard.

Die Postscript-Standardgröße QPageSize::Folio unterscheidet sich von der Windows-Größe DMPAPER_FOLIO, verwenden Sie bei Bedarf die Postscript-Standardgröße QPageSize::FanFoldGermanLegal.

enum QPageSize::SizeMatchPolicy

KonstanteWertBeschreibung
QPageSize::FuzzyMatch0Passt zu einem Standardseitenformat, wenn es innerhalb der Toleranzspanne liegt.
QPageSize::FuzzyOrientationMatch1Anpassen an ein Standardseitenformat, wenn es innerhalb des Toleranzbereichs liegt, unabhängig von der Ausrichtung.
QPageSize::ExactMatch2Entspricht nur dann einer Standardseitengröße, wenn die Größen genau übereinstimmen.

enum QPageSize::Unit

Dieser Enum-Typ wird verwendet, um die Maßeinheit für Seitengrößen anzugeben.

KonstanteWertBeschreibung
QPageSize::Millimeter0
QPageSize::Point11/72tel eines Zolls
QPageSize::Inch2
QPageSize::Pica31/72stel eines Fußes, 1/6stel eines Zolls, 12 Punkte
QPageSize::Didot41/72stel eines französischen Zolls, 0,375 mm
QPageSize::Cicero51/6tel eines französischen Zolls, 12 Didot, 4,5 mm

Dokumentation der Mitgliederfunktionen

QPageSize::QPageSize()

Erzeugt eine Null QPageSize.

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

Erzeugt eine QPageSize des Standards pageSize.

Wenn pageSize gleich QPageSize::Custom ist, ist die resultierende QPageSize nicht gültig. Verwenden Sie stattdessen den Konstruktor für die benutzerdefinierte Größe.

[explicit] QPageSize::QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Erzeugt eine QPageSize der angegebenen pointSize in Points unter Verwendung der passenden matchPolicy.

Wenn die angegebene pointSize mit einer Standardgröße QPageSize::PageSizeId übereinstimmt, wird diese Seitengröße verwendet. Beachten Sie, dass wenn matchPolicy FuzzyMatch ist, dies dazu führen kann, dass pointSize an die Standardgröße angepasst wird. Um dies zu verhindern, verwenden Sie stattdessen eine matchPolicy von ExactMatch.

Wenn die angegebene pointSize keine Standardgröße QPageSize::PageSizeId ist, wird eine QPageSize::Custom Größe erstellt.

Wenn name null ist, wird der lokalisierte Standardname verwendet. Wenn es sich um eine benutzerdefinierte Seitengröße handelt, wird ein benutzerdefinierter Name im Format "Custom (width x height)" erstellt.

Der Standardwert für matchPolicy ist FuzzyMatch.

[explicit] QPageSize::QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Erzeugt eine benutzerdefinierte Seite der angegebenen size in units.

Wenn die angegebene size einem Standard QPageSize::PageSizeId entspricht, wird diese Seitengröße verwendet. Beachten Sie, dass, wenn die matchPolicy FuzzyMatch ist, dies dazu führen kann, dass size an die Standardgröße angepasst wird. Um dies zu verhindern, verwenden Sie stattdessen eine matchPolicy von ExactMatch.

Wenn die angegebene size keine Standardgröße QPageSize::PageSizeId ist, wird eine QPageSize::Custom Größe erstellt. Die ursprüngliche Einheitsgröße wird beibehalten und als Basis für alle anderen Einheitsgrößenberechnungen verwendet.

Ist name gleich Null, wird ein benutzerdefinierter Name in der Form "Benutzerdefiniert (Breite x Höhe)" erstellt, wobei die Größe in den angegebenen Einheiten ausgedrückt wird.

QPageSize::QPageSize(const QPageSize &other)

Kopier-Konstruktor, kopiert other in diesen.

[noexcept] QPageSize::~QPageSize()

Zerstört die Seite.

QSizeF QPageSize::definitionSize() const

Gibt die Definitionsgröße der Seitengröße zurück.

Bei einer Standardseitengröße ist dies die in der entsprechenden Norm definierte Größe, d. h. ISO A4 wird in Millimetern definiert, während ANSI Letter in Zoll definiert wird.

Bei einer benutzerdefinierten Seitengröße ist dies die Originalgröße, die zur Erstellung des Seitengrößenobjekts verwendet wurde.

Wenn QPageSize ungültig ist, ist auch QSizeF ungültig.

Siehe auch definitionUnits().

[static] QSizeF QPageSize::definitionSize(QPageSize::PageSizeId pageSizeId)

Gibt die Definitionsgröße des Standards pageSizeId zurück.

Um die Definitionseinheiten zu erhalten, rufen Sie QPageSize::definitionUnits() auf.

QPageSize::Unit QPageSize::definitionUnits() const

Gibt die Definitionseinheiten der Seitengröße zurück.

Bei einer Standardseitengröße sind dies die in der entsprechenden Norm definierten Einheiten, d. h. ISO A4 wird in Millimetern definiert, während ANSI Letter in Zoll definiert wird.

Bei einer benutzerdefinierten Seitengröße sind dies die ursprünglichen Einheiten, die zur Erstellung des Seitengrößenobjekts verwendet wurden.

Wenn QPageSize ungültig ist, ist auch QPageSize::Unit ungültig.

Siehe auch definitionSize().

[static] QPageSize::Unit QPageSize::definitionUnits(QPageSize::PageSizeId pageSizeId)

Gibt die Definitionseinheiten des Standards pageSizeId zurück.

Um die Definitionsgröße zu erhalten, rufen Sie QPageSize::definitionSize() auf.

QPageSize::PageSizeId QPageSize::id() const

Gibt die Standard-ID QPageSize::PageSizeId der Seite zurück, oder QPageSize::Custom.

Wenn QPageSize ungültig ist, lautet die ID QPageSize::Custom.

[static] QPageSize::PageSizeId QPageSize::id(int windowsId)

Gibt den PageSizeId für den angegebenen Windows DMPAPER enum Wert windowsId zurück.

Wenn es keinen passenden PageSizeId gibt, wird QPageSize::Custom zurückgegeben.

[static] QPageSize::PageSizeId QPageSize::id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Gibt den Standard QPageSize::PageSizeId des angegebenen pointSize in Punkten unter Verwendung des angegebenen matchPolicy zurück.

Wenn Sie FuzzyMatch verwenden, stimmt die Punktgröße des zurückgegebenen PageSizeId möglicherweise nicht genau mit dem von Ihnen übergebenen pointSize überein. Sie sollten QPageSize::sizePoints() unter Verwendung des zurückgegebenen PageSizeId aufrufen, um die tatsächliche Punktgröße von PageSizeId herauszufinden, bevor Sie sie in Berechnungen verwenden.

[static] QPageSize::PageSizeId QPageSize::id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Gibt den Standard QPageSize::PageSizeId des angegebenen size in units unter Verwendung des angegebenen matchPolicy zurück.

Wenn Sie FuzzyMatch verwenden, stimmt die Einheitsgröße des zurückgegebenen PageSizeId möglicherweise nicht genau mit dem von Ihnen übergebenen size überein. Sie sollten QPageSize::size() unter Verwendung des zurückgegebenen PageSizeId aufrufen, um die tatsächliche Einheitsgröße von PageSizeId herauszufinden, bevor Sie sie in Berechnungen verwenden.

bool QPageSize::isEquivalentTo(const QPageSize &other) const

Gibt true zurück, wenn diese Seite der Seite other entspricht, d. h. wenn die Seite unabhängig von anderen Attributen wie Name die gleiche Größe hat.

bool QPageSize::isValid() const

Gibt true zurück, wenn diese Seitengröße gültig ist.

Die Seitengröße kann ungültig sein, wenn sie mit einem ungültigen PageSizeId, einem negativen oder ungültigen QSize oder QSizeF oder dem Null-Konstruktor erstellt wurde.

QString QPageSize::key() const

Gibt den eindeutigen Schlüssel der Seitengröße zurück.

Standardmäßig ist dies das PPD-Standardschlüsselwort mediaOption für die Seitengröße oder der PPD-Schlüssel für das benutzerdefinierte Format. Wenn die Instanz QPageSize von einem Druckgerät bezogen wurde, ist dies der vom Druckgerät bereitgestellte Schlüssel, der vom Standardschlüssel abweichen kann.

Wenn QPageSize ungültig ist, ist der Schlüssel eine leere Zeichenfolge.

Dieser Schlüssel sollte niemals dem Endbenutzer angezeigt werden, er ist nur ein interner Schlüssel. Für einen menschenlesbaren Namen verwenden Sie name().

Siehe auch name().

[static] QString QPageSize::key(QPageSize::PageSizeId pageSizeId)

Gibt das PPD mediaOption-Schlüsselwort des Standards pageSizeId zurück.

Wenn QPageSize ungültig ist, ist der Schlüssel leer.

QString QPageSize::name() const

Gibt einen lokalisierten, von Menschen lesbaren Namen für die Seitengröße zurück.

Wenn die Instanz QPageSize von einem Druckgerät bezogen wurde, wird der Name verwendet, der vom Druckgerät bereitgestellt wurde. Beachten Sie, dass ein Druckgerät möglicherweise nicht die aktuelle Standard-Locale-Sprache unterstützt.

Wenn QPageSize ungültig ist, ist der Name eine leere Zeichenfolge.

[static] QString QPageSize::name(QPageSize::PageSizeId pageSizeId)

Gibt den lokalisierten Namen des Standards pageSizeId zurück.

Wenn QPageSize ungültig ist, ist der Name leer.

QRectF QPageSize::rect(QPageSize::Unit units) const

Gibt das Seitenrechteck in der gewünschten units zurück.

Wenn QPageSize ungültig ist, ist auch QRect ungültig.

QRect QPageSize::rectPixels(int resolution) const

Gibt das Seitenrechteck in Gerätepixeln an der angegebenen resolution zurück.

Wenn QPageSize ungültig ist, ist auch QRect ungültig.

QRect QPageSize::rectPoints() const

Gibt das Seitenrechteck in Postscript-Punkten (1/72 Zoll) zurück.

Wenn QPageSize ungültig ist, ist auch QRect ungültig.

QSizeF QPageSize::size(QPageSize::Unit units) const

Gibt die Größe der Seite in der gewünschten units zurück.

Wenn QPageSize ungültig ist, ist auch QSizeF ungültig.

[static] QSizeF QPageSize::size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)

Gibt die Größe des Standards pageSizeId in der angeforderten units zurück.

QSize QPageSize::sizePixels(int resolution) const

Gibt die Größe der Seite in Device Pixels an der angegebenen resolution zurück.

Wenn QPageSize ungültig ist, ist auch QSize ungültig.

[static] QSize QPageSize::sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)

Gibt die Größe des Standards pageSizeId in Device Pixels für die angegebene resolution zurück.

QSize QPageSize::sizePoints() const

Gibt die Größe der Seite in Postscript-Punkten (1/72 Zoll) zurück.

Wenn QPageSize ungültig ist, ist auch QSize ungültig.

[static] QSize QPageSize::sizePoints(QPageSize::PageSizeId pageSizeId)

Gibt die Größe des Standards pageSizeId in Punkten zurück.

[noexcept] void QPageSize::swap(QPageSize &other)

Tauscht diese QPageSize mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

int QPageSize::windowsId() const

Gibt den Windows DMPAPER enum-Wert für die Seitengröße zurück.

Nicht alle gültigen PPD-Seitengrößen haben eine Windows-Entsprechung; in diesem Fall wird 0 zurückgegeben.

Wenn QPageSize ungültig ist, wird die Windows-ID 0 sein.

Siehe auch id().

[static] int QPageSize::windowsId(QPageSize::PageSizeId pageSizeId)

Gibt den Windows DMPAPER enum-Wert des Standards pageSizeId zurück.

Nicht alle gültigen PPD-Seitengrößen haben eine Windows-Entsprechung; in diesem Fall wird 0 zurückgegeben.

[noexcept] QPageSize &QPageSize::operator=(QPageSize &&other)

Move - weist other dieser QPageSize Instanz zu und überträgt den Besitz des verwalteten Zeigers auf diese Instanz.

QPageSize &QPageSize::operator=(const QPageSize &other)

Zuweisungsoperator, weist diesem other zu.

Verwandte Nicht-Mitglieder

bool operator!=(const QPageSize &lhs, const QPageSize &rhs)

Gibt true zurück, wenn die Seitengröße lhs ungleich der Seitengröße rhs ist, d.h. wenn die Seitengröße unterschiedliche Attribute hat. Aktuelle Attribute sind Größe und Name.

bool operator==(const QPageSize &lhs, const QPageSize &rhs)

Gibt true zurück, wenn die Seitengröße lhs gleich der Seitengröße rhs ist, d.h. wenn die Seitengrößen die gleichen Attribute haben. Aktuelle Attribute sind Größe und Name.

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