QPageLayout Class

Documentation sur les fonctions des membres

QPageLayout::QPageLayout()

Crée un QPageLayout non valide.

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

Crée une QPageLayout avec les éléments pageSize, orientation et margins dans l'élément units.

Il est possible de définir les marges minimales autorisées minMargins, par exemple les marges minimales pouvant être imprimées par un périphérique d'impression physique.

La QPageLayout construite sera dans StandardMode.

Les pages margins données seront calées sur les marges minimales et maximales autorisées par la taille de la page.

QPageLayout::QPageLayout(const QPageLayout &other)

Copy constructor, copie other dans this.

[noexcept] QPageLayout::~QPageLayout()

Détruit la mise en page.

QRectF QPageLayout::fullRect() const

Renvoie le rectangle de la page complète dans les unités de mise en page actuelles.

Le rectangle de page tient compte de la taille et de l'orientation de la page, mais pas de ses marges.

Voir aussi paintRect() et units().

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

Renvoie le rectangle de la page complète dans le format requis units.

Le rectangle de page tient compte de la taille et de l'orientation de la page, mais pas de ses marges.

Voir également paintRect().

QRect QPageLayout::fullRectPixels(int resolution) const

Renvoie le rectangle de la page complète en pixels de l'appareil pour l'adresse resolution donnée.

Le rectangle de page tient compte de la taille et de l'orientation de la page, mais pas de ses marges.

Voir également paintRect().

QRect QPageLayout::fullRectPoints() const

Renvoie le rectangle de la page entière en points Postscript (1/72 de pouce).

Le rectangle de page tient compte de la taille et de l'orientation de la page, mais pas de ses marges.

Voir aussi paintRect().

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

Renvoie true si cette mise en page est équivalente à la mise en page other, c'est-à-dire si la page a la même taille, les mêmes marges et la même orientation.

bool QPageLayout::isValid() const

Renvoie true si cette mise en page est valide.

QMarginsF QPageLayout::margins() const

Renvoie les marges de la mise en page en utilisant les unités actuellement définies.

Voir aussi setMargins() et units().

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

Renvoie les marges de la mise en page à l'aide de l'adresse units.

Voir aussi setMargins() et margins().

QMargins QPageLayout::marginsPixels(int resolution) const

Renvoie les marges de la mise en page en pixels de périphérique pour l'adresse resolution donnée.

Voir aussi setMargins().

QMargins QPageLayout::marginsPoints() const

Renvoie les marges de la mise en page en points Postscript (1/72 de pouce).

Voir aussi setMargins() et margins().

QMarginsF QPageLayout::maximumMargins() const

Renvoie les marges maximales qui seraient appliquées si la mise en page était dans StandardMode.

Les marges maximales autorisées sont calculées comme la taille totale de la page moins les marges minimales définies. Par exemple, si la largeur de la page est de 100 points et que la marge droite minimale est de 10 points, la marge gauche maximale sera de 90 points.

Voir également setMinimumMargins() et minimumMargins().

QMarginsF QPageLayout::minimumMargins() const

Renvoie les marges minimales de la mise en page.

Voir aussi setMinimumMargins() et maximumMargins().

QPageLayout::Mode QPageLayout::mode() const

Renvoie le mode de mise en page.

Voir aussi setMode().

QPageLayout::Orientation QPageLayout::orientation() const

Renvoie l'orientation de la page de la mise en page.

Voir aussi setOrientation().

QPageSize QPageLayout::pageSize() const

Renvoie la taille de la page de la mise en page.

Notez que le site QPageSize est toujours défini dans une orientation Portrait. Pour obtenir une taille qui tienne compte de l'orientation définie, vous devez utiliser fullRect().

Voir également setPageSize().

QRectF QPageLayout::paintRect() const

Renvoie le rectangle de la page dans les unités de mise en page actuelles.

Le rectangle à peindre tient compte de la taille, de l'orientation et des marges de la page.

Si le mode FullPageMode est activé, fullRect() est renvoyé et les marges doivent être gérées manuellement.

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

Renvoie le rectangle de la page dans le format requis units.

Le rectangle à peindre tient compte de la taille, de l'orientation et des marges de la page.

Si le mode FullPageMode est activé, fullRect() est renvoyé et les marges doivent être gérées manuellement.

QRect QPageLayout::paintRectPixels(int resolution) const

Renvoie le rectangle à peindre en pixels arrondis pour l'appareil donné resolution.

Le rectangle à peindre tient compte de la taille de la page, de l'orientation et des marges.

Si le mode FullPageMode est défini, fullRect() est renvoyé et les marges doivent être gérées manuellement.

QRect QPageLayout::paintRectPoints() const

Renvoie le rectangle à peindre en points Postscript arrondis (1/72 de pouce).

Le rectangle à peindre tient compte de la taille de la page, de l'orientation et des marges.

Si le mode FullPageMode est activé, fullRect() est renvoyé et les marges doivent être gérées manuellement.

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

Fixe la marge inférieure de la mise en page à bottomMargin. Renvoie un résultat positif si la marge a été définie avec succès.

Les unités utilisées sont celles actuellement définies pour la mise en page. Pour utiliser des unités différentes, appelez d'abord setUnits().

Depuis Qt 6.8, l'option outOfBoundsPolicy peut être utilisée pour spécifier comment les marges hors limites sont traitées.

Voir aussi setMargins() et margins().

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

Définit la marge gauche de la mise en page à leftMargin. Renvoie un résultat positif si la marge a été définie avec succès.

Les unités utilisées sont celles actuellement définies pour la mise en page. Pour utiliser des unités différentes, appelez d'abord setUnits().

Depuis Qt 6.8, l'option outOfBoundsPolicy peut être utilisée pour spécifier comment les marges hors limites sont traitées.

Voir aussi setMargins() et margins().

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

Définit les marges de la mise en page à margins. Retourne vrai si les marges ont été définies avec succès.

Les unités utilisées sont celles actuellement définies pour la mise en page. Pour utiliser des unités différentes, appelez d'abord setUnits().

Depuis Qt 6.8, l'option outOfBoundsPolicy peut être utilisée pour spécifier comment les marges hors limites sont traitées.

Voir aussi margins() et units().

void QPageLayout::setMinimumMargins(const QMarginsF &minMargins)

Définit les marges minimales de la mise en page à minMargins.

Il n'est pas recommandé de remplacer les valeurs par défaut définies pour une taille de page, car il peut s'agir de la zone imprimable minimale pour un périphérique d'impression physique.

Si le mode StandardMode est défini, les marges existantes seront ajustées à la nouvelle valeur minMargins et au maximum autorisé par la taille de la page. Si le mode FullPageMode est activé, les marges existantes restent inchangées.

Voir également minimumMargins() et setMargins().

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

Définit un mode de mise en page à mode.

Voir aussi mode().

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

Définit l'orientation de la mise en page sur orientation.

La modification de l'orientation n'affecte pas les marges actuelles ni les marges minimales.

Voir également orientation().

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

Définit la taille de la page de la mise en page à pageSize.

Définissez éventuellement les marges minimales autorisées minMargins, par exemple les marges minimales pouvant être imprimées par un périphérique d'impression physique, sinon les marges minimales seront fixées par défaut à 0.

Si StandardMode est défini, les marges existantes seront calées sur les nouvelles marges minimales et les marges maximales autorisées par la taille de la page. Si FullPageMode est défini, les marges existantes resteront inchangées.

Voir aussi pageSize().

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

Fixe la marge droite de la mise en page à rightMargin. Renvoie un résultat positif si la marge a été définie avec succès.

Les unités utilisées sont celles actuellement définies pour la mise en page. Pour utiliser des unités différentes, appelez d'abord setUnits().

Depuis Qt 6.8, l'option outOfBoundsPolicy peut être utilisée pour spécifier comment les marges hors limites sont traitées.

Voir aussi setMargins() et margins().

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

Définit la marge supérieure de la mise en page à topMargin. Renvoie un résultat positif si la marge a été définie avec succès.

Les unités utilisées sont celles actuellement définies pour la mise en page. Pour utiliser des unités différentes, appelez d'abord setUnits().

Depuis Qt 6.8, l'option outOfBoundsPolicy peut être utilisée pour spécifier comment les marges hors limites sont traitées.

Voir aussi setMargins() et margins().

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

Définit le site units utilisé pour définir la mise en page.

Voir aussi units().

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

Remplace cette mise en page par other. Cette opération est très rapide et n'échoue jamais.

QPageLayout::Unit QPageLayout::units() const

Renvoie les unités dans lesquelles la mise en page est actuellement définie.

Voir aussi setUnits().

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

Move-assigne other à cette instance QPageLayout, en transférant la propriété du pointeur géré à cette instance.

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

L'opérateur d'affectation, attribue other à ceci.