Qt 5.6 | Qt Core | C++ Classes | QMargins

Qt 5.6.2 Reference Documentation

# QMargins Class

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

Header: | #include <QMargins>
qmake: | QT += core
Since: | Qt 4.6

- List of all members, including inherited members

## Public Functions

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

## Related Non-Members

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)

## Detailed Description

The QMargins class defines the four margins of a rectangle.

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

Constructs a margins object with all margins set to 0.

See also isNull().

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

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

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

### 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().

### int QMargins::right() const

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().

### 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/=().

### 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/=().

### 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-=().

### 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+=().

### 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*=().

### 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`.

### 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/=().

### 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/=().

### 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/=().

### 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/=().

### 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-=().

### 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-=().

### 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-=().

### 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.

### 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-=().

### 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-=().

### 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.

### 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/=().

### 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.