QPageLayout Class

Dokumentation der Mitgliederfunktionen

QPageLayout::QPageLayout()

Erzeugt ein ungültiges QPageLayout.

QPageLayout::QPageLayout(const QPageSize &pageSize, QPageLayout::Orientation orientation, const QMarginsF &margins, QPageLayout::Unit units = Point, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0))

Erzeugt ein QPageLayout mit den angegebenen pageSize, orientation und margins im angegebenen units.

Definieren Sie optional die minimal erlaubten Ränder minMargins, z.B. die minimalen Ränder, die von einem physischen Druckgerät gedruckt werden können.

Das konstruierte QPageLayout wird in StandardMode sein.

Die angegebene margins wird auf die minimalen und maximalen Ränder, die durch die Seitengröße erlaubt sind, geklemmt.

QPageLayout::QPageLayout(const QPageLayout &other)

Kopier-Konstruktor, kopiert other in diesen.

[noexcept] QPageLayout::~QPageLayout()

Zerstört das Seitenlayout.

QRectF QPageLayout::fullRect() const

Gibt das vollständige Seitenrechteck in den aktuellen Layout-Einheiten zurück.

Das Seitenrechteck berücksichtigt die Seitengröße und die Seitenausrichtung, aber nicht die Seitenränder.

Siehe auch paintRect() und units().

QRectF QPageLayout::fullRect(QPageLayout::Unit units) const

Liefert das vollständige Seitenrechteck in der gewünschten units.

Das Seitenrechteck berücksichtigt die Seitengröße und die Seitenausrichtung, aber nicht die Seitenränder.

Siehe auch paintRect().

QRect QPageLayout::fullRectPixels(int resolution) const

Gibt das vollständige Seitenrechteck in Gerätepixeln für die angegebene resolution zurück.

Das Seitenrechteck berücksichtigt die Seitengröße und die Seitenausrichtung, aber nicht die Seitenränder.

Siehe auch paintRect().

QRect QPageLayout::fullRectPoints() const

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

Das Seitenrechteck berücksichtigt die Seitengröße und die Seitenausrichtung, aber nicht die Seitenränder.

Siehe auch paintRect().

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

Gibt true zurück, wenn dieses Seitenlayout dem Seitenlayout other entspricht, d. h. wenn die Seite die gleiche Größe, die gleichen Ränder und die gleiche Ausrichtung hat.

bool QPageLayout::isValid() const

Gibt true zurück, wenn dieses Seitenlayout gültig ist.

QMarginsF QPageLayout::margins() const

Gibt die Ränder des Seitenlayouts unter Verwendung der aktuell eingestellten Einheiten zurück.

Siehe auch setMargins() und units().

QMarginsF QPageLayout::margins(QPageLayout::Unit units) const

Gibt die Ränder des Seitenlayouts unter Verwendung der angeforderten units zurück.

Siehe auch setMargins() und margins().

QMargins QPageLayout::marginsPixels(int resolution) const

Gibt die Ränder des Seitenlayouts in Gerätepixeln für die angegebene resolution zurück.

Siehe auch setMargins().

QMargins QPageLayout::marginsPoints() const

Gibt die Ränder des Seitenlayouts in Postscript-Punkten (1/72 Zoll) zurück.

Siehe auch setMargins() und margins().

QMarginsF QPageLayout::maximumMargins() const

Gibt die maximalen Ränder zurück, die angewendet würden, wenn das Seitenlayout in StandardMode wäre.

Die maximal zulässigen Ränder werden berechnet als die volle Größe der Seite abzüglich der festgelegten Mindestränder. Wenn zum Beispiel die Seitenbreite 100 Punkte beträgt und der minimale rechte Rand 10 Punkte, dann beträgt der maximale linke Rand 90 Punkte.

Siehe auch setMinimumMargins() und minimumMargins().

QMarginsF QPageLayout::minimumMargins() const

Gibt die Mindestränder des Seitenlayouts zurück.

Siehe auch setMinimumMargins() und maximumMargins().

QPageLayout::Mode QPageLayout::mode() const

Gibt den Seitenlayoutmodus zurück.

Siehe auch setMode().

QPageLayout::Orientation QPageLayout::orientation() const

Gibt die Seitenausrichtung des Seitenlayouts zurück.

Siehe auch setOrientation().

QPageSize QPageLayout::pageSize() const

Gibt die Seitengröße des Seitenlayouts zurück.

Beachten Sie, dass QPageSize immer in der Ausrichtung Hochformat definiert ist. Um eine Größe zu erhalten, die die eingestellte Ausrichtung berücksichtigt, müssen Sie fullRect() verwenden.

Siehe auch setPageSize().

QRectF QPageLayout::paintRect() const

Gibt das Seitenrechteck in den aktuellen Layout-Einheiten zurück.

Das malbare Rechteck berücksichtigt die Seitengröße, die Ausrichtung und die Ränder.

Wenn der Modus FullPageMode eingestellt ist, wird fullRect() zurückgegeben und die Ränder müssen manuell verwaltet werden.

QRectF QPageLayout::paintRect(QPageLayout::Unit units) const

Liefert das Seitenrechteck in der gewünschten units.

Das malbare Rechteck berücksichtigt die Seitengröße, die Ausrichtung und die Ränder.

Wenn der Modus FullPageMode eingestellt ist, wird fullRect() zurückgegeben und die Ränder müssen manuell verwaltet werden.

QRect QPageLayout::paintRectPixels(int resolution) const

Gibt das übermalbare Rechteck in gerundeten Gerätepixeln für die angegebene resolution zurück.

Das übermalbare Rechteck berücksichtigt die Seitengröße, die Ausrichtung und die Ränder.

Wenn der Modus FullPageMode eingestellt ist, wird fullRect() zurückgegeben und die Ränder müssen manuell verwaltet werden.

QRect QPageLayout::paintRectPoints() const

Liefert das übermalbare Rechteck in gerundeten Postscript-Punkten (1/72 Zoll).

Das übermalbare Rechteck berücksichtigt die Seitengröße, die Ausrichtung und die Ränder.

Wenn der Modus FullPageMode eingestellt ist, wird fullRect() zurückgegeben und die Ränder müssen manuell verwaltet werden.

bool QPageLayout::setBottomMargin(qreal bottomMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)

Setzt den unteren Seitenrand des Seitenlayouts auf bottomMargin. Gibt true zurück, wenn der Rand erfolgreich gesetzt wurde.

Es werden die Einheiten verwendet, die derzeit für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zuerst setUnits() auf.

Seit Qt 6.8 kann die optionale outOfBoundsPolicy verwendet werden, um anzugeben, wie Ränder, die außerhalb der Grenzen liegen, behandelt werden.

Siehe auch setMargins() und margins().

bool QPageLayout::setLeftMargin(qreal leftMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)

Setzt den linken Seitenrand des Seitenlayouts auf leftMargin. Gibt true zurück, wenn der Rand erfolgreich gesetzt wurde.

Es werden die Einheiten verwendet, die derzeit für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zuerst setUnits() auf.

Seit Qt 6.8 kann die optionale outOfBoundsPolicy verwendet werden, um anzugeben, wie Ränder, die außerhalb der Grenzen liegen, behandelt werden.

Siehe auch setMargins() und margins().

bool QPageLayout::setMargins(const QMarginsF &margins, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)

Setzt die Seitenränder des Seitenlayouts auf margins. Gibt true zurück, wenn die Ränder erfolgreich eingestellt wurden.

Es werden die Einheiten verwendet, die derzeit für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zuerst setUnits() auf.

Seit Qt 6.8 kann das optionale outOfBoundsPolicy verwendet werden, um anzugeben, wie Ränder, die außerhalb der Grenzen liegen, behandelt werden.

Siehe auch margins() und units().

void QPageLayout::setMinimumMargins(const QMarginsF &minMargins)

Setzt die minimalen Seitenränder des Seitenlayouts auf minMargins.

Es wird nicht empfohlen, die für eine Seitengröße eingestellten Standardwerte zu überschreiben, da es sich dabei um den minimalen druckbaren Bereich für ein physisches Druckgerät handeln kann.

Wenn der Modus StandardMode eingestellt ist, werden die vorhandenen Ränder auf den neuen minMargins und den für die Seitengröße zulässigen Höchstwert geklemmt. Wenn der Modus FullPageMode eingestellt ist, bleiben die vorhandenen Ränder unverändert.

Siehe auch minimumMargins() und setMargins().

void QPageLayout::setMode(QPageLayout::Mode mode)

Setzt einen Seitenlayoutmodus auf mode.

Siehe auch mode().

void QPageLayout::setOrientation(QPageLayout::Orientation orientation)

Setzt die Seitenausrichtung des Seitenlayouts auf orientation.

Eine Änderung der Ausrichtung hat keine Auswirkungen auf die aktuellen Ränder oder die Mindestränder.

Siehe auch orientation().

void QPageLayout::setPageSize(const QPageSize &pageSize, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0))

Legt die Seitengröße des Seitenlayouts auf pageSize fest.

Legen Sie optional die minimal zulässigen Ränder minMargins fest, z. B. die minimalen Ränder, die von einem physischen Druckgerät gedruckt werden können, andernfalls werden die minimalen Ränder standardmäßig auf 0 gesetzt.

Wenn StandardMode eingestellt ist, werden die vorhandenen Ränder auf die neuen Mindestränder und die für die Seitengröße zulässigen Höchstränder geklemmt. Wenn FullPageMode gesetzt ist, bleiben die vorhandenen Ränder unverändert.

Siehe auch pageSize().

bool QPageLayout::setRightMargin(qreal rightMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)

Setzt den rechten Seitenrand des Seitenlayouts auf rightMargin. Gibt true zurück, wenn der Rand erfolgreich gesetzt wurde.

Es werden die Einheiten verwendet, die derzeit für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zuerst setUnits() auf.

Seit Qt 6.8 kann die optionale outOfBoundsPolicy verwendet werden, um anzugeben, wie Ränder, die außerhalb der Grenzen liegen, behandelt werden.

Siehe auch setMargins() und margins().

bool QPageLayout::setTopMargin(qreal topMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)

Setzt den oberen Seitenrand des Seitenlayouts auf topMargin. Gibt true zurück, wenn der Rand erfolgreich gesetzt wurde.

Es werden die Einheiten verwendet, die derzeit für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zuerst setUnits() auf.

Seit Qt 6.8 kann die optionale outOfBoundsPolicy verwendet werden, um anzugeben, wie Ränder, die außerhalb der Grenzen liegen, behandelt werden.

Siehe auch setMargins() und margins().

void QPageLayout::setUnits(QPageLayout::Unit units)

Legt die units fest, die zur Definition des Seitenlayouts verwendet wird.

Siehe auch units().

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

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

QPageLayout::Unit QPageLayout::units() const

Gibt die Einheiten zurück, in denen das Seitenlayout derzeit definiert ist.

Siehe auch setUnits().

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

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

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

Zuweisungsoperator, weist diesem other zu.