QMargins Class
QMargins 类定义了矩形的四个边距。更多内容...
| 头文件： | #include <QMargins> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake： | QT += core |
- 所有成员的列表，包括继承的成员
- QMargins 属于“绘图类”的一部分。
QMargins 比较
| 类别 | 可比较类型 |
|---|---|
| 相等性 | QMargins |
| 相等 | QMarginsF. |
公共函数
| 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) |
详细说明
QMargin 定义了一组由四个边距（左、上、右、下）组成的集合，用于描述矩形周围边框的大小。
只有当所有边距均设置为零时，isNull() 函数才会返回true 。
QMargin 对象既可以进行流式传输，也可以进行比较。
成员函数文档
[constexpr noexcept] QMargins::QMargins()
创建一个所有边距均设置为 0 的 margins 对象。
另请参阅 isNull()。
[constexpr noexcept] QMargins::QMargins(int left, int top, int right, int bottom)
使用给定的left 、top 、right 和bottom
另请参阅 setLeft()、setRight()、setTop() 以及setBottom()。
[constexpr noexcept] int QMargins::bottom() const
返回底部边距。
另请参阅 ` setBottom()`。
[constexpr noexcept] bool QMargins::isNull() const
如果所有边距均为 0，则返回true ；否则返回 false。
[constexpr noexcept] int QMargins::left() const
返回左边距。
另请参阅 setLeft()。
[constexpr noexcept] int QMargins::right() const
返回右边距。
另请参阅 setRight()。
[constexpr noexcept] void QMargins::setBottom(int bottom)
将底部边距设置为bottom 。
另请参阅 bottom()。
[constexpr noexcept] void QMargins::setLeft(int left)
将左边距设置为left 。
另请参阅 left()。
[constexpr noexcept] void QMargins::setRight(int right)
将右边距设置为right 。
另请参阅 right()。
[constexpr noexcept] void QMargins::setTop(int Top)
将顶部边距设置为Top 。
另请参阅 top()。
[constexpr noexcept, since 6.4] QMarginsF QMargins::toMarginsF() const
将这些边距作为具有浮点精度的边距返回。
该函数在 Qt 6.4 中引入。
另请参阅 QMarginsF::toMargins()。
[constexpr noexcept] int QMargins::top() const
返回顶部边距。
另请参阅 ` setTop()`。
[constexpr noexcept] QMargins &QMargins::operator*=(int factor)
将该对象的每个分量乘以factor ，并返回对其的引用。
另请参阅 operator/=()。
[constexpr noexcept] QMargins &QMargins::operator*=(qreal factor)
将该对象的每个分量乘以factor ，并返回对其的引用。
这是一个重载函数。
另请参阅 operator/=()。
[constexpr noexcept] QMargins &QMargins::operator+=(const QMargins &margins)
将margins 中的每个组件添加到该对象的相应组件中，并返回对其的引用。
另请参阅 operator-=()。
[constexpr noexcept] QMargins &QMargins::operator+=(int addend)
将addend 添加到该对象的每个组件中，并返回对其的引用。
这是一个重载函数。
另请参阅 operator-=()。
[constexpr noexcept] QMargins &QMargins::operator-=(const QMargins &margins)
从该对象的相应组件中减去margins 的每个组件，并返回对其的引用。
另请参阅 operator+=()。
[constexpr noexcept] QMargins &QMargins::operator-=(int subtrahend)
从该对象的每个分量中减去subtrahend ，并返回该结果的引用。
这是一个重载函数。
另请参阅 operator+=()。
[constexpr] QMargins &QMargins::operator/=(int divisor)
将该对象的每个组件除以divisor ，并返回对其的引用。
另请参阅 operator*=()。
[constexpr] QMargins &QMargins::operator/=(qreal divisor)
这是一个重载函数。
另请参阅 operator*=()。
相关的非成员
[constexpr noexcept] bool operator!=(const QMargins &lhs, const QMargins &rhs)
如果 `lhs ` 和 `rhs ` 不相等，则返回 `true `；否则返回 `false`。
[constexpr noexcept] QMargins operator*(const QMargins &margins, int factor)
返回一个QMargins 对象，该对象是通过将给定的margins 的每个分量与factor 相乘而得到的。
另请参阅 QMargins::operator*=() 和QMargins::operator/=()。
[constexpr noexcept] QMargins operator*(const QMargins &margins, qreal factor)
返回一个QMargins 对象，该对象通过将给定的margins 的每个分量与factor 相乘而生成。
这是一个重载函数。
另请参阅 QMargins::operator*=() 和QMargins::operator/=()。
[constexpr noexcept] QMargins operator*(int factor, const QMargins &margins)
返回一个QMargins 对象，该对象是通过将给定的margins 的每个分量与factor 相乘而形成的。
这是一个重载函数。
另请参阅 QMargins::operator*=() 和QMargins::operator/=()。
[constexpr noexcept] QMargins operator*(qreal factor, const QMargins &margins)
返回一个QMargins 对象，该对象是通过将给定的margins 的每个分量与factor 相乘而形成的。
这是一个重载函数。
另请参阅 QMargins::operator*=() 和QMargins::operator/=()。
[constexpr noexcept] QMargins operator+(const QMargins &margins)
返回一个由margins 的所有组件构成的QMargin对象。
[constexpr noexcept] QMargins operator+(const QMargins &m1, const QMargins &m2)
返回一个QMargins 对象，该对象是给定的边距m1 和m2 的总和；每个分量分别相加。
另请参阅 QMargins::operator+=() 和QMargins::operator-=()。
[constexpr noexcept] QMargins operator+(const QMargins &lhs, int rhs)
返回一个由rhs 与lhs 相加生成的QMargins 对象。
另请参阅 QMargins::operator+=() 和QMargins::operator-=()。
[constexpr noexcept] QMargins operator+(int lhs, const QMargins &rhs)
返回一个由将lhs 与rhs 相加生成的QMargins 对象。
另请参阅 QMargins::operator+=() 和QMargins::operator-=()。
[constexpr noexcept] QMargins operator-(const QMargins &margins)
返回一个 QMargin 对象，该对象由将margins 的所有分量取反后形成。
[constexpr noexcept] QMargins operator-(const QMargins &m1, const QMargins &m2)
返回一个由m1 减去m2 形成的QMargins 对象；每个分量分别进行减法运算。
另请参阅 QMargins::operator+=() 和QMargins::operator-=()。
[constexpr noexcept] QMargins operator-(const QMargins &lhs, int rhs)
返回一个由lhs 减去rhs 生成的QMargins 对象。
另请参阅 QMargins::operator+=() 和QMargins::operator-=()。
[constexpr] QMargins operator/(const QMargins &margins, int divisor)
返回一个QMargins 对象，该对象是通过将给定的margins 的各分量除以给定的divisor 而构成的。
另请参阅 QMargins::operator*=() 和QMargins::operator/=()。
[constexpr] QMargins operator/(const QMargins &margins, qreal divisor)
返回一个QMargins 对象，该对象通过将给定的margins 的各分量除以给定的divisor 生成。
这是一个重载函数。
另请参阅 QMargins::operator*=() 和QMargins::operator/=()。
QDataStream &operator<<(QDataStream &stream, const QMargins &m)
将边距m 写入指定的stream ，并返回该流的引用。
另请参阅 《Qt 数据类型的序列化》。
[constexpr noexcept] bool operator==(const QMargins &lhs, const QMargins &rhs)
如果 `lhs ` 和 `rhs ` 相等，则返回 `true `；否则返回 `false`。
QDataStream &operator>>(QDataStream &stream, QMargins &m)
从给定的stream 中读取一个边距到m 中，并返回对该流的引用。
另请参阅 《Qt 数据类型的序列化》。
[constexpr noexcept, since 6.0] QMargins operator|(const QMargins &m1, const QMargins &m2)
返回一个由 `m2 ` 和 `m1` 的各分量最大值组成的 `QMargins ` 对象。
该函数在 Qt 6.0 中引入。
另请参阅 QMargins::operator+=() 和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.
