En esta página

QMargins Class

La clase QMargins define los cuatro márgenes de un rectángulo. Más información...

Encabezado: #include <QMargins>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Comparativas de QMargins

CategoríaTipos comparables
igualdadQMargins
igualdadQMarginsF.

Funciones públicas

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)

Descripción detallada

QMargin define un conjunto de cuatro márgenes —izquierdo, superior, derecho e inferior— que describen el tamaño de los bordes que rodean un rectángulo.

La función ` isNull()` devuelve ` true ` solo si todos los márgenes están establecidos en cero.

Los objetos QMargin pueden transmitirse y compararse.

Documentación de las funciones miembro

[constexpr noexcept] QMargins::QMargins()

Crea un objeto «margins» con todos los márgenes establecidos en 0.

Véase también ` isNull()`.

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

Crea márgenes con los valores indicados: left, top, right y bottom

Véanse también setLeft(), setRight(), setTop() y setBottom().

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

Devuelve el margen inferior.

Véase también setBottom().

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

Devuelve « true » si todos los márgenes son 0; en caso contrario, devuelve «false».

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

Devuelve el margen izquierdo.

Véase también ` setLeft()`.

Devuelve el margen derecho.

Véase también setRight().

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

Establece el margen inferior en « bottom ».

Véase también bottom().

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

Establece el margen izquierdo en left.

Véase también left().

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

Establece el margen derecho en right.

Véase también right().

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

Establece el margen superior en Top.

Véase también top().

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

Devuelve estos márgenes con precisión de punto flotante.

Esta función se introdujo en Qt 6.4.

Véase también QMarginsF::toMargins().

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

Devuelve el margen superior.

Véase también setTop().

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

Multiplica cada componente de este objeto por factor y devuelve una referencia al mismo.

Véase también ` operator/=()`.

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

Multiplica cada componente de este objeto por « factor » y devuelve una referencia al mismo.

Esta es una función sobrecargada.

Véase también ` operator/=()`.

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

Añade cada componente de margins al componente correspondiente de este objeto y devuelve una referencia al mismo.

Véase también operator-=().

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

Añade el objeto « addend » a cada componente de este objeto y devuelve una referencia al mismo.

Esta es una función sobrecargada.

Véase también operator-=().

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

Resta cada componente de margins del componente correspondiente de este objeto y devuelve una referencia al mismo.

Véase también operator+=().

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

Resta el objeto « subtrahend » de cada componente de este objeto y devuelve una referencia al mismo.

Esta es una función sobrecargada.

Véase también operator+=().

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

Divide cada componente de este objeto entre divisor y devuelve una referencia al mismo.

Véase también operator*=().

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

Esta es una función sobrecargada.

Véase también operator*=().

Elementos no miembros relacionados

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

Devuelve « true » si « lhs » y « rhs » son diferentes; en caso contrario, devuelve « false ».

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

Devuelve un objeto ` QMargins ` que se obtiene multiplicando cada componente del objeto ` margins ` dado por ` factor`.

Véase también QMargins::operator*=() y QMargins::operator/=().

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

Devuelve un objeto ` QMargins ` que se forma multiplicando cada componente de la matriz dada ` margins ` por ` factor`.

Esta es una función sobrecargada.

Véanse también QMargins::operator*=() y QMargins::operator/=().

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

Devuelve un objeto ` QMargins ` que se obtiene multiplicando cada componente del objeto ` margins ` dado por ` factor`.

Esta es una función sobrecargada.

Véanse también QMargins::operator*=() y QMargins::operator/=().

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

Devuelve un objeto ` QMargins ` que se obtiene multiplicando cada componente de la matriz dada ` margins ` por ` factor`.

Esta es una función sobrecargada.

Véanse también QMargins::operator*=() y QMargins::operator/=().

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

Devuelve un objeto QMargin formado a partir de todos los componentes de ` margins`.

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

Devuelve un objeto ` QMargins ` que es la suma de los márgenes indicados: ` m1 ` y ` m2`; cada componente se suma por separado.

Véase también QMargins::operator+=() y QMargins::operator-=().

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

Devuelve un objeto ` QMargins ` que se crea sumando ` rhs ` a ` lhs`.

Véase también QMargins::operator+=() y QMargins::operator-=().

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

Devuelve un objeto ` QMargins ` que se forma añadiendo ` lhs ` a ` rhs`.

Véase también QMargins::operator+=() y QMargins::operator-=().

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

Devuelve un objeto QMargin que se forma invirtiendo todos los componentes de un margins.

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

Devuelve un objeto ` QMargins ` que se obtiene restando ` m2 ` de ` m1`; cada componente se resta por separado.

Véase también QMargins::operator+=() y QMargins::operator-=().

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

Devuelve un objeto ` QMargins ` que se obtiene restando ` rhs ` de ` lhs`.

Véase también QMargins::operator+=() y QMargins::operator-=().

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

Devuelve un objeto de tipo ` QMargins ` que se forma dividiendo los componentes de la ` margins ` dada por la ` divisor` dada.

Véase también QMargins::operator*=() y QMargins::operator/=().

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

Devuelve un objeto ` QMargins ` que se forma dividiendo los componentes del ` margins ` dado por el ` divisor` dado.

Esta es una función sobrecargada.

Véase también QMargins::operator*=() y QMargins::operator/=().

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

Escribe el margen m en el stream indicado y devuelve una referencia al flujo.

Véase también «Serialización detipos de datos de Qt».

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

Devuelve « true » si « lhs » y « rhs » son iguales; en caso contrario, devuelve « false ».

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

Lee un margen desde el archivo « stream » especificado en el archivo « m » y devuelve una referencia al flujo.

Véase también «Serialización detipos de datos de Qt».

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

Devuelve un objeto ` QMargins ` formado por el valor máximo de cada componente de ` m2 ` y ` m1`.

Esta función se introdujo en Qt 6.0.

Véase también QMargins::operator+=() y 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.