QPageLayout Class

Dokumentation der Mitgliedsfunktionen

QPageLayout::QPageLayout()

Erstellt 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))

Erstellt ein QPageLayout mit den angegebenen Werten für „ pageSize “, „ orientation “ und „ margins “ im angegebenen „ units “.

Optional können die minimal zulässigen Ränder minMargins definiert werden, z. B. die minimalen Ränder, die von einem physischen Druckgerät gedruckt werden können.

Das erstellte `QPageLayout` befindet sich in ` StandardMode`.

Das angegebene ` margins ` wird auf die minimalen und maximalen Ränder begrenzt, die aufgrund der Seitengröße zulässig sind.

QPageLayout::QPageLayout(const QPageLayout &other)

Kopierkonstruktor, kopiert „ other “ in „this“.

[noexcept] QPageLayout::~QPageLayout()

Bringt das Seitenlayout durcheinander.

QRectF QPageLayout::fullRect() const

Gibt das Rechteck der gesamten Seite in den aktuellen Layout-Einheiten zurück.

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

Siehe auch „ paintRect()“ und „ units()“.

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

Gibt das Rechteck der gesamten Seite im gewünschten Format „ units “ zurück.

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

Siehe auch ` paintRect()`.

QRect QPageLayout::fullRectPixels(int resolution) const

Gibt das Rechteck der gesamten Seite in Gerätepixeln für die angegebene „ resolution “ zurück.

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

Siehe auch „ paintRect()“.

QRect QPageLayout::fullRectPoints() const

Gibt das Rechteck der gesamten Seite in PostScript-Punkten (1/72 Zoll) zurück.

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

Siehe auch „ paintRect“ ().

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

Gibt „ true “ zurück, wenn dieses Seitenlayout mit dem Seitenlayout „ other “ übereinstimmt, d. h., wenn die Seite dieselbe Größe, dieselben Ränder und dieselbe Ausrichtung aufweist.

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 des angegebenen „ 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 auf „ StandardMode “ eingestellt wäre.

Die zulässigen maximalen Ränder werden berechnet als die Gesamtgröße der Seite abzüglich der festgelegten Mindestränder. Beträgt beispielsweise die Seitenbreite 100 Punkte und der minimale rechte Rand 10 Punkte, so beträgt der maximale linke Rand 90 Punkte.

Siehe auch „ setMinimumMargins()“ und „ minimumMargins()“.

QMarginsF QPageLayout::minimumMargins() const

Gibt die minimalen Rä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 die Funktion „ QPageSize “ immer im Hochformat definiert ist. Um eine Größe zu erhalten, die die festgelegte Ausrichtung berücksichtigt, müssen Sie die Funktion „ 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.

Ist der Modus „ FullPageMode “ aktiviert, wird die Funktion „ fullRect()“ zurückgegeben, und die Ränder müssen manuell verwaltet werden.

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

Gibt das Seitenrechteck im gewünschten Format „ units “ zurück.

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

Ist der Modus „ FullPageMode “ aktiviert, wird die Funktion „ fullRect()“ zurückgegeben, und die Ränder müssen manuell verwaltet werden.

QRect QPageLayout::paintRectPixels(int resolution) const

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

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

Ist der Modus „ FullPageMode “ aktiviert, wird die Funktion „ fullRect()“ zurückgegeben, und die Ränder müssen manuell verwaltet werden.

QRect QPageLayout::paintRectPoints() const

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

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

Ist der Modus „ FullPageMode “ aktiviert, wird die Funktion „ 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 festgelegt wurde.

Es werden die Einheiten verwendet, die aktuell für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zunächst ` setUnits()` auf.

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

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 festgelegt wurde.

Es werden die Einheiten verwendet, die aktuell für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zunächst ` setUnits()` auf.

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

Siehe auch setMargins() und margins().

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

Legt die Seitenränder des Seitenlayouts auf „ margins “ fest. Gibt „true“ zurück, wenn die Seitenränder erfolgreich festgelegt wurden.

Es werden die Einheiten verwendet, die aktuell für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zunächst ` setUnits()` auf.

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

Siehe auch ` margins()` und ` units()`.

void QPageLayout::setMinimumMargins(const QMarginsF &minMargins)

Legt die Mindestrandbreiten des Seitenlayouts auf „ minMargins “ fest.

Es wird nicht empfohlen, die für eine Seitengröße festgelegten Standardwerte zu überschreiben, da dies möglicherweise der kleinste druckbare Bereich für ein physisches Druckgerät ist.

Wenn der Modus „ StandardMode “ eingestellt ist, werden die vorhandenen Ränder auf den neuen Wert „ minMargins “ und den für die Seitengröße maximal zulässigen Wert begrenzt. 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 den Seitenlayoutmodus auf „ mode “.

Siehe auch mode().

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

Legt die Seitenausrichtung des Seitenlayouts auf „ orientation “ fest.

Das Ändern 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.

Optional können die minimal zulässigen Ränder minMargins definiert werden, 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 “ festgelegt ist, werden die vorhandenen Ränder auf die neuen Mindestränder und die durch die Seitengröße zugelassenen Höchstränder begrenzt. Wenn „ FullPageMode “ festgelegt 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 festgelegt wurde.

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

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

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 festgelegt wurde.

Es werden die Einheiten verwendet, die aktuell für das Layout definiert sind. Um andere Einheiten zu verwenden, rufen Sie zunächst ` setUnits()` auf.

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

Siehe auch setMargins() und margins().

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

Legt das „ units “ fest, das zur Definition des Seitenlayouts verwendet wird.

Siehe auch ` units()`.

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

Ersetzt dieses Seitenlayout durch other. Dieser Vorgang ist sehr schnell und schlägt niemals 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)

Mit „Move-assigns“ wird „ other “ dieser „ QPageLayout “-Instanz zugewiesen, wodurch das Eigentumsrecht am verwalteten Zeiger auf diese Instanz übertragen wird.

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

Zuweisungsoperator, weist „ other “ der Variablen „this“ zu.