Sur cette page

QMargins Class

La classe QMargins définit les quatre marges d'un rectangle. En savoir plus...

En-tête : #include <QMargins>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core

Comparaisons de QMargins

CatégorieTypes comparables
égalitéQMargins
égalitéQMarginsF.

Fonctions publiques

QMargins()
QMargins(int left, int top, int right, int bottom)
int bottom() const
bool isNull() const
int left() const
int right() const
void setBottom(int bottom)
void setLeft(int left)
void setRight(int right)
void setTop(int Top)
(since 6.4) QMarginsF toMarginsF() const
int top() const
QMargins &operator*=(int factor)
QMargins &operator*=(qreal factor)
QMargins &operator+=(const QMargins &margins)
QMargins &operator+=(int addend)
QMargins &operator-=(const QMargins &margins)
QMargins &operator-=(int subtrahend)
QMargins &operator/=(int divisor)
QMargins &operator/=(qreal divisor)
bool operator!=(const QMargins &lhs, const QMargins &rhs)
QMargins operator*(const QMargins &margins, int factor)
QMargins operator*(const QMargins &margins, qreal factor)
QMargins operator*(int factor, const QMargins &margins)
QMargins operator*(qreal factor, const QMargins &margins)
QMargins operator+(const QMargins &margins)
QMargins operator+(const QMargins &m1, const QMargins &m2)
QMargins operator+(const QMargins &lhs, int rhs)
QMargins operator+(int lhs, const QMargins &rhs)
QMargins operator-(const QMargins &margins)
QMargins operator-(const QMargins &m1, const QMargins &m2)
QMargins operator-(const QMargins &lhs, int rhs)
QMargins operator/(const QMargins &margins, int divisor)
QMargins operator/(const QMargins &margins, qreal divisor)
QDataStream &operator<<(QDataStream &stream, const QMargins &m)
bool operator==(const QMargins &lhs, const QMargins &rhs)
QDataStream &operator>>(QDataStream &stream, QMargins &m)
(since 6.0) QMargins operator|(const QMargins &m1, const QMargins &m2)

Description détaillée

QMargin définit un ensemble de quatre marges : gauche, haut, droite et bas, qui décrivent la taille des bordures entourant un rectangle.

La fonction isNull() renvoie true uniquement si toutes les marges sont définies sur zéro.

Les objets QMargin peuvent être transmis par flux et comparés.

Documentation des fonctions membres

[constexpr noexcept] QMargins::QMargins()

Crée un objet « margins » dont toutes les marges sont définies sur 0.

Voir aussi isNull().

[constexpr noexcept] QMargins::QMargins(int left, int top, int right, int bottom)

Crée des marges à l'aide des éléments left, top, right et bottom

Voir également setLeft(), setRight(), setTop() et setBottom().

[constexpr noexcept] int QMargins::bottom() const

Renvoie la marge inférieure.

Voir aussi setBottom().

[constexpr noexcept] bool QMargins::isNull() const

Renvoie « true » si toutes les marges sont égales à 0 ; sinon, renvoie « false ».

[constexpr noexcept] int QMargins::left() const

Renvoie la marge gauche.

Voir aussi setLeft().

Renvoie la marge droite.

Voir aussi setRight().

[constexpr noexcept] void QMargins::setBottom(int bottom)

Définit la marge inférieure à bottom.

Voir également bottom().

[constexpr noexcept] void QMargins::setLeft(int left)

Définit la marge gauche sur left.

Voir aussi left().

[constexpr noexcept] void QMargins::setRight(int right)

Définit la marge droite à right.

Voir également right().

[constexpr noexcept] void QMargins::setTop(int Top)

Définit la marge supérieure sur Top.

Voir aussi top().

[constexpr noexcept, since 6.4] QMarginsF QMargins::toMarginsF() const

Renvoie ces marges sous forme de valeurs à virgule flottante.

Cette fonction a été introduite dans Qt 6.4.

Voir également QMarginsF::toMargins().

[constexpr noexcept] int QMargins::top() const

Renvoie la marge supérieure.

Voir aussi setTop().

[constexpr noexcept] QMargins &QMargins::operator*=(int factor)

Multiplie chaque composant de cet objet par factor et renvoie une référence à celui-ci.

Voir également operator/=().

[constexpr noexcept] QMargins &QMargins::operator*=(qreal factor)

Multiplie chaque composant de cet objet par factor et renvoie une référence à celui-ci.

Il s'agit d'une fonction surchargée.

Voir également operator/=().

[constexpr noexcept] QMargins &QMargins::operator+=(const QMargins &margins)

Ajoute chaque composant de margins au composant correspondant de cet objet et renvoie une référence à celui-ci.

Voir également operator-=().

[constexpr noexcept] QMargins &QMargins::operator+=(int addend)

Ajoute l'addend e à chaque composant de cet objet et renvoie une référence à celui-ci.

Il s'agit d'une fonction surchargée.

Voir également operator-=().

[constexpr noexcept] QMargins &QMargins::operator-=(const QMargins &margins)

Soustrait chaque composant de margins du composant correspondant de cet objet et renvoie une référence à celui-ci.

Voir aussi operator+=().

[constexpr noexcept] QMargins &QMargins::operator-=(int subtrahend)

Soustrait l'subtrahend e de chaque composant de cet objet et renvoie une référence à celui-ci.

Il s'agit d'une fonction surchargée.

Voir aussi operator+=().

[constexpr] QMargins &QMargins::operator/=(int divisor)

Divise chaque composant de cet objet par divisor et renvoie une référence à celui-ci.

Voir également operator*=().

[constexpr] QMargins &QMargins::operator/=(qreal divisor)

Il s'agit d'une fonction surchargée.

Voir également operator*=().

Éléments non-membres associés

[constexpr noexcept] bool operator!=(const QMargins &lhs, const QMargins &rhs)

Renvoie « true » si « lhs » et « rhs » sont différents ; sinon, renvoie « false ».

[constexpr noexcept] QMargins operator*(const QMargins &margins, int factor)

Renvoie un objet ` QMargins ` obtenu en multipliant chaque composant de l'margins on fournie par ` factor`.

Voir également QMargins::operator*=() et QMargins::operator/=().

[constexpr noexcept] QMargins operator*(const QMargins &margins, qreal factor)

Renvoie un objet de type ` QMargins ` obtenu en multipliant chaque composant de l'margins on fournie par ` factor`.

Il s'agit d'une fonction surchargée.

Voir également QMargins::operator*=() et QMargins::operator/=().

[constexpr noexcept] QMargins operator*(int factor, const QMargins &margins)

Renvoie un objet de type ` QMargins ` obtenu en multipliant chaque composante de l'margins on fournie par ` factor`.

Il s'agit d'une fonction surchargée.

Voir également QMargins::operator*=() et QMargins::operator/=().

[constexpr noexcept] QMargins operator*(qreal factor, const QMargins &margins)

Renvoie un objet de type ` QMargins ` obtenu en multipliant chaque composante de l’ margins on fournie par ` factor`.

Il s'agit d'une fonction surchargée.

Voir également QMargins::operator*=() et QMargins::operator/=().

[constexpr noexcept] QMargins operator+(const QMargins &margins)

Renvoie un objet QMargin constitué de tous les composants d'margins.

[constexpr noexcept] QMargins operator+(const QMargins &m1, const QMargins &m2)

Renvoie un objet ` QMargins ` correspondant à la somme des marges indiquées : ` m1 ` et ` m2` ; chaque composante est additionnée séparément.

Voir également QMargins::operator+=() et QMargins::operator-=().

[constexpr noexcept] QMargins operator+(const QMargins &lhs, int rhs)

Renvoie un objet ` QMargins ` obtenu en ajoutant ` rhs ` à ` lhs`.

Voir également QMargins::operator+=() et QMargins::operator-=().

[constexpr noexcept] QMargins operator+(int lhs, const QMargins &rhs)

Renvoie un objet ` QMargins ` obtenu en ajoutant ` lhs ` à ` rhs`.

Voir également QMargins::operator+=() et QMargins::operator-=().

[constexpr noexcept] QMargins operator-(const QMargins &margins)

Renvoie un objet QMargin obtenu en inversant le signe de toutes les composantes de ` margins`.

[constexpr noexcept] QMargins operator-(const QMargins &m1, const QMargins &m2)

Renvoie un objet ` QMargins ` obtenu en soustrayant ` m2 ` de ` m1` ; chaque composante est soustraite séparément.

Voir également QMargins::operator+=() et QMargins::operator-=().

[constexpr noexcept] QMargins operator-(const QMargins &lhs, int rhs)

Renvoie un objet ` QMargins ` obtenu en soustrayant ` rhs ` de ` lhs`.

Voir également QMargins::operator+=() et QMargins::operator-=().

[constexpr] QMargins operator/(const QMargins &margins, int divisor)

Renvoie un objet de type ` QMargins ` obtenu en divisant les composantes de l'margins donné par l'divisor donné.

Voir également QMargins::operator*=() et QMargins::operator/=().

[constexpr] QMargins operator/(const QMargins &margins, qreal divisor)

Renvoie un objet ` QMargins ` obtenu en divisant les composantes de l'margins donné par l'divisor donné.

Il s'agit d'une fonction surchargée.

Voir également QMargins::operator*=() et QMargins::operator/=().

QDataStream &operator<<(QDataStream &stream, const QMargins &m)

Écrit l'm de marge dans le flux stream spécifié et renvoie une référence à ce flux.

Voir également Sérialisation des types de données Qt.

[constexpr noexcept] bool operator==(const QMargins &lhs, const QMargins &rhs)

Renvoie « true » si « lhs » et « rhs » sont égaux ; sinon, renvoie « false ».

QDataStream &operator>>(QDataStream &stream, QMargins &m)

Lit une marge à partir de l'stream donné dans la marge m et renvoie une référence au flux.

Voir également Sérialisation des types de données Qt.

[constexpr noexcept, since 6.0] QMargins operator|(const QMargins &m1, const QMargins &m2)

Renvoie un objet ` QMargins ` constitué de la valeur maximale de chaque composante de ` m2 ` et ` m1`.

Cette fonction a été introduite dans Qt 6.0.

Voir également QMargins::operator+=() et QMargins::operator-=().

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