QMargins Class
QMargins 类定义了矩形的四个边距。更多
| 头文件： | #include <QMargins> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake： | QT += core |
- 所有成员（包括继承成员）的列表
- 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()
构造 margins 对象，并将所有 margins 设置为 0。
另请参阅 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
以浮点精度返回 margins。
此函数在 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)
返回QMargins 对象，该对象由rhs 与lhs 相加而成。
另请参阅 QMargins::operator+=() 和QMargins::operator-=()。
[constexpr noexcept] QMargins operator+(int lhs, const QMargins &rhs)
返回QMargins 对象，该对象由lhs 与rhs 相加而成。
另请参阅 QMargins::operator+=() 和QMargins::operator-=()。
[constexpr noexcept] QMargins operator-(const QMargins &margins)
返回一个 QMargin 对象，该对象由margins 的所有分量否定而成。
[constexpr noexcept] QMargins operator-(const QMargins &m1, const QMargins &m2)
返回一个QMargins 对象，该对象由m2 与m1 相减而得，每个部分分别相减。
另请参阅 QMargins::operator+=() 和QMargins::operator-=()。
[constexpr noexcept] QMargins operator-(const QMargins &lhs, int rhs)
返回一个QMargins 对象，该对象由lhs 减去rhs 形成。
另请参见 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)
将 marginm 写入给定的stream ，并返回对该数据流的引用。
另请参阅 序列化 Qt 数据类型。
[constexpr noexcept] bool operator==(const QMargins &lhs, const QMargins &rhs)
如果lhs 和rhs 相等，则返回true ；否则返回false 。
QDataStream &operator>>(QDataStream &stream, QMargins &m)
从给定的stream 中读取 margin 到 marginm ，并返回对该数据流的引用。
另请参阅 序列化 Qt 数据类型。
[constexpr noexcept, since 6.0] QMargins operator|(const QMargins &m1, const QMargins &m2)
返回一个QMargins 对象，该对象由m2 和m1 中每个分量的最大值构成。
此函数在 Qt 6.0 中引入。
另请参阅 QMargins::operator+=() 和QMargins::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.
