QMarginsF Class
QMarginsF 类定义了矩形的四个边距。更多
| 头文件： | #include <QMarginsF> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake： | QT += core |
- 所有成员（包括继承成员）的列表
- QMarginsF 属于绘画类。
该类可等价比较。
该类可与QMargins 进行等价比较。
公共函数
| QMarginsF() | |
| QMarginsF(const QMargins &margins) | |
| QMarginsF(qreal left, qreal top, qreal right, qreal bottom) | |
| qreal | bottom() const |
| bool | isNull() const |
| qreal | left() const |
| qreal | right() const |
| void | setBottom(qreal abottom) |
| void | setLeft(qreal aleft) |
| void | setRight(qreal aright) |
| void | setTop(qreal atop) |
| QMargins | toMargins() const |
| qreal | top() const |
| QMarginsF & | operator*=(qreal factor) |
| QMarginsF & | operator+=(const QMarginsF &margins) |
| QMarginsF & | operator+=(qreal addend) |
| QMarginsF & | operator-=(const QMarginsF &margins) |
| QMarginsF & | operator-=(qreal subtrahend) |
| QMarginsF & | operator/=(qreal divisor) |
相关非成员
(since 6.8) bool | qFuzzyCompare(const QMarginsF &lhs, const QMarginsF &rhs) |
(since 6.8) bool | qFuzzyIsNull(const QMarginsF &margins) |
| bool | operator!=(const QMarginsF &lhs, const QMarginsF &rhs) |
| QMarginsF | operator*(const QMarginsF &lhs, qreal rhs) |
| QMarginsF | operator*(qreal lhs, const QMarginsF &rhs) |
| QMarginsF | operator+(const QMarginsF &margins) |
| QMarginsF | operator+(const QMarginsF &lhs, const QMarginsF &rhs) |
| QMarginsF | operator+(const QMarginsF &lhs, qreal rhs) |
| QMarginsF | operator+(qreal lhs, const QMarginsF &rhs) |
| QMarginsF | operator-(const QMarginsF &margins) |
| QMarginsF | operator-(const QMarginsF &lhs, const QMarginsF &rhs) |
| QMarginsF | operator-(const QMarginsF &lhs, qreal rhs) |
| QMarginsF | operator/(const QMarginsF &lhs, qreal rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QMarginsF &m) |
| bool | operator==(const QMarginsF &lhs, const QMarginsF &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QMarginsF &m) |
(since 6.0) QMarginsF | operator|(const QMarginsF &m1, const QMarginsF &m2) |
详细描述
QMarginsF 定义了一组四个边距（左、上、右、下），用于描述矩形周围边框的有限大小。
只有当所有边距都非常接近于零时，函数isNull() 才会返回true 。
QMarginsF 对象可以流式传输，也可以比较。
成员函数文档
[constexpr noexcept] QMarginsF::QMarginsF()
构造 margins 对象，并将所有 margins 设置为 0。
另请参阅 isNull()。
[constexpr noexcept] QMarginsF::QMarginsF(const QMargins &margins)
构造从给定的margins 中复制的边距。
另请参阅 QMargins::toMarginsF() 。
[constexpr noexcept] QMarginsF::QMarginsF(qreal left, qreal top, qreal right, qreal bottom)
用给定的left,top,right, 和bottom 构建边距。所有参数必须是有限的。
另请参阅 setLeft(),setRight(),setTop() 和setBottom() 。
[constexpr noexcept] qreal QMarginsF::bottom() const
返回底边距。
另请参见 setBottom()。
[constexpr noexcept] bool QMarginsF::isNull() const
如果所有边距都非常接近 0，则返回true ；否则返回 false。
另请参见 qFuzzyIsNull().
[constexpr noexcept] qreal QMarginsF::left() const
返回左边距。
另请参见 setLeft()。
[constexpr noexcept] qreal QMarginsF::right() const
返回右边距。
另请参见 setRight()。
[constexpr noexcept] void QMarginsF::setBottom(qreal abottom)
将底边距设置为abottom （必须是有限的）。
另请参阅 bottom().
[constexpr noexcept] void QMarginsF::setLeft(qreal aleft)
将左页边距设置为aleft （必须是有限的）。
另请参阅 left().
[constexpr noexcept] void QMarginsF::setRight(qreal aright)
将右边距设置为aright （必须是有限的）。
另请参阅 right().
[constexpr noexcept] void QMarginsF::setTop(qreal atop)
将顶边距设置为atop （必须是有限的）。
另请参阅 top().
[constexpr noexcept] QMargins QMarginsF::toMargins() const
返回 margins 对象的整数副本。
请注意，返回的 margins 中的分量将四舍五入为最接近的整数。
另请参阅 QMarginsF() 和QMargins::toMarginsF()。
[constexpr noexcept] qreal QMarginsF::top() const
返回顶边距。
另请参见 setTop()。
[constexpr noexcept] QMarginsF &QMarginsF::operator*=(qreal factor)
将此对象的每个分量与给定的有限factor 相乘，并返回此对象的引用。
另请参见 operator/=()。
[constexpr noexcept] QMarginsF &QMarginsF::operator+=(const QMarginsF &margins)
将margins 的每个组件添加到此对象的相应组件中，并返回一个引用。
另请参见 operator-=()。
[constexpr noexcept] QMarginsF &QMarginsF::operator+=(qreal addend)
这是一个重载函数。
将给定的有限addend 添加到此对象的每个组件中，并返回一个引用。
另请参见 operator-=()。
[constexpr noexcept] QMarginsF &QMarginsF::operator-=(const QMarginsF &margins)
将margins 的每个分量从该对象的相应分量中减去，并返回一个引用。
另请参见 operator+=()。
[constexpr noexcept] QMarginsF &QMarginsF::operator-=(qreal subtrahend)
这是一个重载函数。
从该对象的每个分量中减去给定的有限subtrahend ，并返回一个引用。
另请参见 operator+=()。
[constexpr] QMarginsF &QMarginsF::operator/=(qreal divisor)
将此对象的每个分量除以divisor ，并返回此对象的引用。
divisor 不能为零或 NaN。
另请参见 operator*=()。
相关非成员
[constexpr noexcept, since 6.8] bool qFuzzyCompare(const QMarginsF &lhs, const QMarginsF &rhs)
如果lhs 近似等于rhs ，则返回true ；否则返回false 。
此函数在 Qt 6.8 中引入。
[constexpr noexcept, since 6.8] bool qFuzzyIsNull(const QMarginsF &margins)
如果 margsinsmargins 的所有分量近似等于零，则返回true ；否则返回false 。
此函数在 Qt 6.8 中引入。
[constexpr noexcept] bool operator!=(const QMarginsF &lhs, const QMarginsF &rhs)
如果lhs 和rhs 足够不同，则返回true ；否则返回false 。
警告： 此函数不检查严格不等式；而是使用模糊比较来比较差值。
另请参见 qFuzzyCompare 。
[constexpr noexcept] QMarginsF operator*(const QMarginsF &lhs, qreal rhs)
这是一个重载函数。
返回QMarginsF 对象，该对象由给定的lhs 边距的每个分量乘以有限因子rhs 形成。
另请参阅 QMarginsF::operator*=() 和QMarginsF::operator/=()。
[constexpr noexcept] QMarginsF operator*(qreal lhs, const QMarginsF &rhs)
这是一个重载函数。
返回QMarginsF 对象，该对象由给定的lhs 边距的每个分量乘以有限因子rhs 形成。
另请参阅 QMarginsF::operator*=() 和QMarginsF::operator/=()。
[constexpr noexcept] QMarginsF operator+(const QMarginsF &margins)
返回由margins 的所有分量构成的 QMargin 对象。
[constexpr noexcept] QMarginsF operator+(const QMarginsF &lhs, const QMarginsF &rhs)
返回一个QMarginsF 对象，该对象是给定边距、lhs 和rhs 的总和；每个部分分别相加。
另请参阅 QMarginsF::operator+=() 和QMarginsF::operator-=()。
[constexpr noexcept] QMarginsF operator+(const QMarginsF &lhs, qreal rhs)
返回一个QMarginsF 对象，该对象由lhs 的每个分量加上rhs （必须是有限的）构成。
另请参见 QMarginsF::operator+=() 和QMarginsF::operator-=()。
[constexpr noexcept] QMarginsF operator+(qreal lhs, const QMarginsF &rhs)
返回一个QMarginsF 对象，该对象由rhs 的每个分量加上lhs （必须是有限的）构成。
另请参见 QMarginsF::operator+=() 和QMarginsF::operator-=()。
[constexpr noexcept] QMarginsF operator-(const QMarginsF &margins)
返回一个 QMargin 对象，该对象由margins 的所有分量否定而成。
[constexpr noexcept] QMarginsF operator-(const QMarginsF &lhs, const QMarginsF &rhs)
返回一个QMarginsF 对象，该对象由rhs 与lhs 相减而成；每个部分分别相减。
另请参阅 QMarginsF::operator+=() 和QMarginsF::operator-=()。
[constexpr noexcept] QMarginsF operator-(const QMarginsF &lhs, qreal rhs)
返回一个QMarginsF 对象，该对象由lhs 的每个分量减去rhs （必须是有限的）形成。
另请参见 QMarginsF::operator+=() 和QMarginsF::operator-=()。
[constexpr] QMarginsF operator/(const QMarginsF &lhs, qreal rhs)
这是一个重载函数。
返回一个QMarginsF 对象，该对象由给定的lhs 边距的分量除以给定的rhs 除数构成。
除数不得为零或 NaN。
另请参阅 QMarginsF::operator*=() 和QMarginsF::operator/=()。
QDataStream &operator<<(QDataStream &stream, const QMarginsF &m)
将 marginm 写入给定的stream ，并返回对该数据流的引用。
另请参阅 序列化 Qt 数据类型。
[constexpr noexcept] bool operator==(const QMarginsF &lhs, const QMarginsF &rhs)
如果lhs 和rhs 大致相等，则返回true ；否则返回 false。
警告： 此函数不检查严格的相等；而是使用模糊比较来比较边距。
另请参见 qFuzzyCompare 。
QDataStream &operator>>(QDataStream &stream, QMarginsF &m)
从给定的stream 中读取 margin 到 marginm ，并返回对该数据流的引用。
另请参阅 序列化 Qt 数据类型。
[constexpr noexcept, since 6.0] QMarginsF operator|(const QMarginsF &m1, const QMarginsF &m2)
这是一个重载函数。
返回一个QMarginsF 对象，该对象由m2 和m1 中每个分量的最大值构成。
此函数在 Qt 6.0 中引入。
另请参阅 QMarginsF::operator+=() 和QMarginsF::operator-=()。
© 2025 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.
