QMargins Class

The QMargins class defines the four margins of a rectangle. More...

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

Public Functions

QMargins(int left, int top, int right, int bottom)
QMargins()
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)
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 &m1, const QMargins &m2)
QMargins operator*(const QMargins &margins, int factor)
QMargins operator*(int factor, const QMargins &margins)
QMargins operator*(const QMargins &margins, qreal factor)
QMargins operator*(qreal factor, 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)
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 &m1, const QMargins &m2)
QDataStream &operator>>(QDataStream &stream, QMargins &m)
QMargins operator|(const QMargins &m1, const QMargins &m2)

Detailed Description

QMargin defines a set of four margins; left, top, right, and bottom, that describe the size of the borders surrounding a rectangle.

The isNull() function returns true only if all margins are set to zero.

QMargin objects can be streamed as well as compared.

Member Function Documentation

QMargins::QMargins(int left, int top, int right, int bottom)

Constructs margins with the given left, top, right, and bottom

See also setLeft(), setRight(), setTop(), and setBottom().

QMargins::QMargins()

Constructs a margins object with all margins set to 0.

See also isNull().

int QMargins::bottom() const

Returns the bottom margin.

See also setBottom().

bool QMargins::isNull() const

Returns true if all margins are is 0; otherwise returns false.

int QMargins::left() const

Returns the left margin.

See also setLeft().

Returns the right margin.

See also setRight().

void QMargins::setBottom(int bottom)

Sets the bottom margin to bottom.

See also bottom().

void QMargins::setLeft(int left)

Sets the left margin to left.

See also left().

void QMargins::setRight(int right)

Sets the right margin to right.

See also right().

void QMargins::setTop(int Top)

Sets the Top margin to Top.

See also top().

int QMargins::top() const

Returns the top margin.

See also setTop().

[since 5.1] QMargins &QMargins::operator*=(int factor)

Multiplies each component of this object by factor and returns a reference to it.

This function was introduced in Qt 5.1.

See also operator/=().

[since 5.1] QMargins &QMargins::operator*=(qreal factor)

This is an overloaded function.

Multiplies each component of this object by factor and returns a reference to it.

This function was introduced in Qt 5.1.

See also operator/=().

[since 5.1] QMargins &QMargins::operator+=(const QMargins &margins)

Add each component of margins to the respective component of this object and returns a reference to it.

This function was introduced in Qt 5.1.

See also operator-=().

QMargins &QMargins::operator+=(int addend)

This is an overloaded function.

Adds the addend to each component of this object and returns a reference to it.

See also operator-=().

[since 5.1] QMargins &QMargins::operator-=(const QMargins &margins)

Subtract each component of margins from the respective component of this object and returns a reference to it.

This function was introduced in Qt 5.1.

See also operator+=().

QMargins &QMargins::operator-=(int subtrahend)

This is an overloaded function.

Subtracts the subtrahend from each component of this object and returns a reference to it.

See also operator+=().

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

Divides each component of this object by divisor and returns a reference to it.

This function was introduced in Qt 5.1.

See also operator*=().

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

This is an overloaded function.

This function was introduced in Qt 5.1.

See also operator*=().

Related Non-Members

bool operator!=(const QMargins &m1, const QMargins &m2)

Returns true if m1 and m2 are different; otherwise returns false.

[since 5.1] QMargins operator*(const QMargins &margins, int factor)

Returns a QMargins object that is formed by multiplying each component of the given margins by factor.

This function was introduced in Qt 5.1.

See also QMargins::operator*=() and QMargins::operator/=().

[since 5.1] QMargins operator*(int factor, const QMargins &margins)

This is an overloaded function.

Returns a QMargins object that is formed by multiplying each component of the given margins by factor.

This function was introduced in Qt 5.1.

See also QMargins::operator*=() and QMargins::operator/=().

[since 5.1] QMargins operator*(const QMargins &margins, qreal factor)

This is an overloaded function.

Returns a QMargins object that is formed by multiplying each component of the given margins by factor.

This function was introduced in Qt 5.1.

See also QMargins::operator*=() and QMargins::operator/=().

[since 5.1] QMargins operator*(qreal factor, const QMargins &margins)

This is an overloaded function.

Returns a QMargins object that is formed by multiplying each component of the given margins by factor.

This function was introduced in Qt 5.1.

See also QMargins::operator*=() and QMargins::operator/=().

[since 5.1] QMargins operator+(const QMargins &m1, const QMargins &m2)

Returns a QMargins object that is the sum of the given margins, m1 and m2; each component is added separately.

This function was introduced in Qt 5.1.

See also QMargins::operator+=() and QMargins::operator-=().

[since 5.3] QMargins operator+(const QMargins &lhs, int rhs)

Returns a QMargins object that is formed by adding rhs to lhs.

This function was introduced in Qt 5.3.

See also QMargins::operator+=() and QMargins::operator-=().

[since 5.3] QMargins operator+(int lhs, const QMargins &rhs)

Returns a QMargins object that is formed by adding lhs to rhs.

This function was introduced in Qt 5.3.

See also QMargins::operator+=() and QMargins::operator-=().

[since 5.3] QMargins operator+(const QMargins &margins)

Returns a QMargin object that is formed from all components of margins.

This function was introduced in Qt 5.3.

[since 5.1] QMargins operator-(const QMargins &m1, const QMargins &m2)

Returns a QMargins object that is formed by subtracting m2 from m1; each component is subtracted separately.

This function was introduced in Qt 5.1.

See also QMargins::operator+=() and QMargins::operator-=().

[since 5.3] QMargins operator-(const QMargins &lhs, int rhs)

Returns a QMargins object that is formed by subtracting rhs from lhs.

This function was introduced in Qt 5.3.

See also QMargins::operator+=() and QMargins::operator-=().

[since 5.1] QMargins operator-(const QMargins &margins)

Returns a QMargin object that is formed by negating all components of margins.

This function was introduced in Qt 5.1.

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

Returns a QMargins object that is formed by dividing the components of the given margins by the given divisor.

This function was introduced in Qt 5.1.

See also QMargins::operator*=() and QMargins::operator/=().

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

This is an overloaded function.

Returns a QMargins object that is formed by dividing the components of the given margins by the given divisor.

This function was introduced in Qt 5.1.

See also QMargins::operator*=() and QMargins::operator/=().

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

Writes margin m to the given stream and returns a reference to the stream.

See also Serializing Qt Data Types.

bool operator==(const QMargins &m1, const QMargins &m2)

Returns true if m1 and m2 are equal; otherwise returns false.

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

Reads a margin from the given stream into margin m and returns a reference to the stream.

See also Serializing Qt Data Types.

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

Returns a QMargins object that is formed from the maximum of each component of m2 and m1.

This function was introduced in Qt 6.0.

See also QMargins::operator+=() and QMargins::operator-=().