\inmodule QtCore More...

#include <qmargins.h>

Inheritance diagram for QMarginsF:

Collaboration diagram for QMarginsF:

Public Member Functions
constexpr	QMarginsF () noexcept
	Constructs a margins object with all margins set to 0.
constexpr	QMarginsF (qreal left, qreal top, qreal right, qreal bottom) noexcept
	Constructs margins with the given left, top, right, and bottom.
constexpr	QMarginsF (const QMargins &margins) noexcept
	Constructs margins copied from the given margins.
constexpr bool	isNull () const noexcept
	Returns `true` if all margins are very close to 0; otherwise returns false.
constexpr qreal	left () const noexcept
	Returns the left margin.
constexpr qreal	top () const noexcept
	Returns the top margin.
constexpr qreal	right () const noexcept
	Returns the right margin.
constexpr qreal	bottom () const noexcept
	Returns the bottom margin.
constexpr void	setLeft (qreal aleft) noexcept
	Sets the left margin to aleft (which must be finite).
constexpr void	setTop (qreal atop) noexcept
	Sets the top margin to atop (which must be finite).
constexpr void	setRight (qreal aright) noexcept
	Sets the right margin to aright (which must be finite).
constexpr void	setBottom (qreal abottom) noexcept
	Sets the bottom margin to abottom (which must be finite).
constexpr QMarginsF &	operator+= (const QMarginsF &margins) noexcept
	Add each component of margins to the respective component of this object and returns a reference to it.
constexpr QMarginsF &	operator-= (const QMarginsF &margins) noexcept
	Subtract each component of margins from the respective component of this object and returns a reference to it.
constexpr QMarginsF &	operator+= (qreal addend) noexcept
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds the given finite addend to each component of this object and returns a reference to it.
constexpr QMarginsF &	operator-= (qreal subtrahend) noexcept
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Subtracts the given finite subtrahend from each component of this object and returns a reference to it.
constexpr QMarginsF &	operator*= (qreal factor) noexcept
	Multiplies each component of this object by the given finite factor and returns a reference to this object.
constexpr QMarginsF &	operator/= (qreal divisor)
	Divides each component of this object by divisor and returns a reference to this object.
constexpr QMargins	toMargins () const noexcept
	Returns an integer-based copy of this margins object.

Friends
constexpr bool	qFuzzyCompare (const QMarginsF &lhs, const QMarginsF &rhs) noexcept
constexpr bool	qFuzzyIsNull (const QMarginsF &m) noexcept
constexpr bool	comparesEqual (const QMarginsF &lhs, const QMarginsF &rhs) noexcept
constexpr bool	comparesEqual (const QMarginsF &lhs, const QMargins &rhs) noexcept
template<std::size_t I, typename M, std::enable_if_t<(I< 4), bool > = true, std::enable_if_t< std::is_same_v< q20::remove_cvref_t< M >, QMarginsF >, bool > = true>
constexpr decltype(auto)	get (M &&m) noexcept

Related Symbols
(Note that these are not member symbols.)
const QMarginsF	operator+ (const QMarginsF &lhs, const QMarginsF &rhs)
	Returns a QMarginsF object that is the sum of the given margins, lhs and rhs; each component is added separately.
const QMarginsF	operator- (const QMarginsF &lhs, const QMarginsF &rhs)
	Returns a QMarginsF object that is formed by subtracting rhs from lhs; each component is subtracted separately.
const QMarginsF	operator+ (const QMarginsF &lhs, qreal rhs)
	Returns a QMarginsF object that is formed by adding rhs (which must be finite) to each component of lhs.
const QMarginsF	operator+ (qreal lhs, const QMarginsF &rhs)
	Returns a QMarginsF object that is formed by adding lhs (which must be finite) to each component of rhs.
const QMarginsF	operator- (const QMarginsF &lhs, qreal rhs)
	Returns a QMarginsF object that is formed by subtracting rhs (which must be finite) from each component of lhs.
const QMarginsF	operator* (const QMarginsF &lhs, qreal rhs)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QMarginsF object that is formed by multiplying each component of the given lhs margins by finite factor rhs.
const QMarginsF	operator* (qreal lhs, const QMarginsF &rhs)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QMarginsF object that is formed by multiplying each component of the given lhs margins by finite factor rhs.
const QMarginsF	operator/ (const QMarginsF &lhs, qreal rhs)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QMarginsF object that is formed by dividing the components of the given lhs margins by the given rhs divisor.
QMarginsF	operator\| (const QMarginsF &m1, const QMarginsF &m2)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QMarginsF object that is formed from the maximum of each component of m2 and m1.
QMarginsF	operator+ (const QMarginsF &margins)
	Returns a QMargin object that is formed from all components of margins.
QMarginsF	operator- (const QMarginsF &margins)
	Returns a QMargin object that is formed by negating all components of margins.
QDataStream &	operator<< (QDataStream &stream, const QMarginsF &m)
	Writes margin m to the given stream and returns a reference to the stream.
QDataStream &	operator>> (QDataStream &stream, QMarginsF &m)
	Reads a margin from the given stream into margin m and returns a reference to the stream.

Detailed Description

\inmodule QtCore

Since: 5.3

\compares equality \compareswith equality QMargins \endcompareswith

The QMarginsF class defines the four margins of a rectangle.

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

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

QMarginsF objects can be streamed as well as compared.

Definition at line 303 of file qmargins.h.

Constructor & Destructor Documentation

◆ QMarginsF() [1/3]

QMarginsF::QMarginsF ( )

inlineconstexprnoexcept

Constructs a margins object with all margins set to 0.

See also: isNull()

Definition at line 392 of file qmargins.h.

References QMarginsF().

Referenced by QMarginsF().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ QMarginsF() [2/3]

QMarginsF::QMarginsF	(	qreal	left,
		qreal	top,
		qreal	right,
		qreal	bottom )

inlineconstexprnoexcept

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

All parameters must be finite.

See also: setLeft(), setRight(), setTop(), setBottom()

Definition at line 395 of file qmargins.h.

References QMarginsF().

Referenced by QMarginsF().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ QMarginsF() [3/3]

QMarginsF::QMarginsF ( const QMargins & margins )

inlineconstexprnoexcept

Constructs margins copied from the given margins.

See also: QMargins::toMarginsF()

Definition at line 398 of file qmargins.h.

References QMarginsF().

Referenced by QMarginsF().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Function Documentation

◆ bottom()

qreal QMarginsF::bottom ( ) const

inlineconstexprnoexcept

Returns the bottom margin.

Definition at line 413 of file qmargins.h.

◆ isNull()

bool QMarginsF::isNull ( ) const

inlineconstexprnoexcept

Returns true if all margins are very close to 0; otherwise returns false.

See also: {<QtNumeric>::}{qFuzzyIsNull()}

Definition at line 401 of file qmargins.h.

◆ left()

qreal QMarginsF::left ( ) const

inlineconstexprnoexcept

Returns the left margin.

See also: setLeft()

Definition at line 404 of file qmargins.h.

◆ operator*=()

QMarginsF & QMarginsF::operator*= ( qreal factor )

inlineconstexprnoexcept

Multiplies each component of this object by the given finite factor and returns a reference to this object.

See also: operator/=()

Definition at line 512 of file qmargins.h.

◆ operator+=() [1/2]

QMarginsF & QMarginsF::operator+= ( const QMarginsF & margins )

inlineconstexprnoexcept

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

See also: operator-=()

Definition at line 484 of file qmargins.h.

References operator+().

Here is the call graph for this function:

◆ operator+=() [2/2]

QMarginsF & QMarginsF::operator+= ( qreal addend )

inlineconstexprnoexcept

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds the given finite addend to each component of this object and returns a reference to it.

See also: operator-=()

Definition at line 494 of file qmargins.h.

◆ operator-=() [1/2]

QMarginsF & QMarginsF::operator-= ( const QMarginsF & margins )

inlineconstexprnoexcept

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

See also: operator+=()

Definition at line 489 of file qmargins.h.

References operator-().

Here is the call graph for this function:

◆ operator-=() [2/2]

QMarginsF & QMarginsF::operator-= ( qreal subtrahend )

inlineconstexprnoexcept

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Subtracts the given finite subtrahend from each component of this object and returns a reference to it.

See also: operator+=()

Definition at line 503 of file qmargins.h.

◆ operator/=()

QMarginsF & QMarginsF::operator/= ( qreal divisor )

inlineconstexpr

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

The divisor must not be either zero or NaN.

See also: operator*=()

Definition at line 517 of file qmargins.h.

◆ right()

qreal QMarginsF::right ( ) const

inlineconstexprnoexcept

Returns the right margin.

Definition at line 410 of file qmargins.h.

◆ setBottom()

void QMarginsF::setBottom ( qreal abottom )

inlineconstexprnoexcept

Sets the bottom margin to abottom (which must be finite).

Definition at line 426 of file qmargins.h.

◆ setLeft()

void QMarginsF::setLeft ( qreal aleft )

inlineconstexprnoexcept

Sets the left margin to aleft (which must be finite).

Definition at line 417 of file qmargins.h.

◆ setRight()

void QMarginsF::setRight ( qreal aright )

inlineconstexprnoexcept

Sets the right margin to aright (which must be finite).

Definition at line 423 of file qmargins.h.

◆ setTop()

void QMarginsF::setTop ( qreal atop )

inlineconstexprnoexcept

Sets the top margin to atop (which must be finite).

Definition at line 420 of file qmargins.h.

◆ toMargins()

QMargins QMarginsF::toMargins ( ) const

inlineconstexprnoexcept

Returns an integer-based copy of this margins object.

Note that the components in the returned margins will be rounded to the nearest integer.

See also: QMarginsF(), QMargins::toMarginsF()

Definition at line 534 of file qmargins.h.

◆ top()

qreal QMarginsF::top ( ) const

inlineconstexprnoexcept

Returns the top margin.

See also: setTop()

Definition at line 407 of file qmargins.h.

◆ comparesEqual [1/2]

bool comparesEqual	(	const QMarginsF &	lhs,
		const QMargins &	rhs )

friend

Definition at line 356 of file qmargins.h.

◆ comparesEqual [2/2]

bool comparesEqual	(	const QMarginsF &	lhs,
		const QMarginsF &	rhs )

friend

Definition at line 350 of file qmargins.h.

References qFuzzyCompare.

◆ get

template<std::size_t I, typename M, std::enable_if_t<(I< 4), bool > = true, std::enable_if_t< std::is_same_v< q20::remove_cvref_t< M >, QMarginsF >, bool > = true>

decltype(auto) get ( M && m )

friend

Definition at line 364 of file qmargins.h.

◆ operator*() [1/2]

const QMarginsF operator*	(	const QMarginsF &	lhs,
		qreal	rhs )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QMarginsF object that is formed by multiplying each component of the given lhs margins by finite factor rhs.

See also: QMarginsF::operator*=(), QMarginsF::operator/=()

Definition at line 459 of file qmargins.h.

◆ operator*() [2/2]

const QMarginsF operator*	(	qreal	lhs,
		const QMarginsF &	rhs )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QMarginsF object that is formed by multiplying each component of the given lhs margins by finite factor rhs.

See also: QMarginsF::operator*=(), QMarginsF::operator/=()

Definition at line 465 of file qmargins.h.

◆ operator+() [1/4]

const QMarginsF operator+	(	const QMarginsF &	lhs,
		const QMarginsF &	rhs )

Returns a QMarginsF object that is the sum of the given margins, lhs and rhs; each component is added separately.

See also: QMarginsF::operator+=(), QMarginsF::operator-=()

Definition at line 429 of file qmargins.h.

◆ operator+() [2/4]

const QMarginsF operator+	(	const QMarginsF &	lhs,
		qreal	rhs )

Returns a QMarginsF object that is formed by adding rhs (which must be finite) to each component of lhs.

See also: QMarginsF::operator+=(), QMarginsF::operator-=()

Definition at line 441 of file qmargins.h.

◆ operator+() [3/4]

QMarginsF operator+ ( const QMarginsF & margins )

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

Definition at line 522 of file qmargins.h.

◆ operator+() [4/4]

const QMarginsF operator+	(	qreal	lhs,
		const QMarginsF &	rhs )

Returns a QMarginsF object that is formed by adding lhs (which must be finite) to each component of rhs.

See also: QMarginsF::operator+=(), QMarginsF::operator-=()

Definition at line 447 of file qmargins.h.

◆ operator-() [1/3]

const QMarginsF operator-	(	const QMarginsF &	lhs,
		const QMarginsF &	rhs )

Returns a QMarginsF object that is formed by subtracting rhs from lhs; each component is subtracted separately.

See also: QMarginsF::operator+=(), QMarginsF::operator-=()

Definition at line 435 of file qmargins.h.

◆ operator-() [2/3]

const QMarginsF operator-	(	const QMarginsF &	lhs,
		qreal	rhs )

Returns a QMarginsF object that is formed by subtracting rhs (which must be finite) from each component of lhs.

See also: QMarginsF::operator+=(), QMarginsF::operator-=()

Definition at line 453 of file qmargins.h.

◆ operator-() [3/3]

QMarginsF operator- ( const QMarginsF & margins )

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

Definition at line 527 of file qmargins.h.

◆ operator/()

const QMarginsF operator/	(	const QMarginsF &	lhs,
		qreal	rhs )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QMarginsF object that is formed by dividing the components of the given lhs margins by the given rhs divisor.

The divisor must not be either zero or NaN.

See also: QMarginsF::operator*=(), QMarginsF::operator/=()

Definition at line 471 of file qmargins.h.

◆ operator<<()

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

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

See also: {Serializing Qt Data Types}

◆ operator>>()

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

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

See also: {Serializing Qt Data Types}

◆ operator|()

QMarginsF operator\|	(	const QMarginsF &	m1,
		const QMarginsF &	m2 )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QMarginsF object that is formed from the maximum of each component of m2 and m1.

See also: QMarginsF::operator+=(), QMarginsF::operator-=()

Since: 6.0

Definition at line 478 of file qmargins.h.

◆ qFuzzyCompare

bool qFuzzyCompare	(	const QMarginsF &	lhs,
		const QMarginsF &	rhs )

friend

Since: 6.8

Returns true if lhs is approximately equal to rhs; otherwise returns false.

Definition at line 337 of file qmargins.h.

Referenced by comparesEqual.

◆ qFuzzyIsNull

bool qFuzzyIsNull ( const QMarginsF & margins )

friend

Since: 6.8

Returns true if all components of margsins margins are approximately equal to zero; otherwise returns false.

Definition at line 344 of file qmargins.h.

The documentation for this class was generated from the following files:

qtbase/src/corelib/tools/qmargins.h (00ff24091d5928492577b7a13e4856bc4c171178)
qtbase/src/corelib/tools/qmargins.cpp (00ff24091d5928492577b7a13e4856bc4c171178)

Public Member Functions

Friends

Related Symbols

Detailed Description

Constructor & Destructor Documentation

◆ QMarginsF() [1/3]

◆ QMarginsF() [2/3]

◆ QMarginsF() [3/3]

Member Function Documentation

◆ bottom()

◆ isNull()

◆ left()

◆ operator*=()

◆ operator+=() [1/2]

◆ operator+=() [2/2]

◆ operator-=() [1/2]

◆ operator-=() [2/2]

◆ operator/=()

◆ right()

◆ setBottom()

◆ setLeft()

◆ setRight()

◆ setTop()

◆ toMargins()

◆ top()

Friends And Related Symbol Documentation

◆ comparesEqual [1/2]

◆ comparesEqual [2/2]

◆ get

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator+() [1/4]

◆ operator+() [2/4]

◆ operator+() [3/4]

◆ operator+() [4/4]

◆ operator-() [1/3]

◆ operator-() [2/3]

◆ operator-() [3/3]

◆ operator/()

◆ operator<<()

◆ operator>>()

◆ operator|()

◆ qFuzzyCompare

◆ qFuzzyIsNull