QRect Class

成员函数文档

[constexpr noexcept] QRect::QRect()

构造一个空矩形。

另请参阅 isNull()。

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QPoint &bottomRight)

构造一个包含topLeft 和bottomRight 两角的矩形。

如果bottomRight 在topLeft 的左上方，则定义的矩形不包含这两个角。

另请参阅 setTopLeft()、setBottomRight() 和span()。

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QSize &size)

构造一个矩形，该矩形的角为topLeft ，角值为size 。

另请参阅 setTopLeft() 和setSize() 。

[constexpr noexcept] QRect::QRect(int x, int y, int width, int height)

构造一个以 (x,y) 为左上角、以width 和height 为给定值的矩形。

另请参见 setRect().

[constexpr noexcept] void QRect::adjust(int dx1, int dy1, int dx2, int dy2)

将dx1,dy1,dx2 和dy2 分别添加到矩形的现有坐标中。

另请参阅 adjusted() 和setRect()。

[constexpr noexcept] QRect QRect::adjusted(int dx1, int dy1, int dx2, int dy2) const

返回一个新矩形，在此矩形的现有坐标上分别添加dx1,dy1,dx2 和dy2 。

另请参见 adjust().

[constexpr noexcept] int QRect::bottom() const

返回矩形底边的 y 坐标。

请注意，由于历史原因，此函数返回top() +height() - 1；使用y() +height() 可获取真正的 y 坐标。

另请参见 setBottom()、bottomLeft() 和bottomRight()。

[constexpr noexcept] QPoint QRect::bottomLeft() const

返回矩形左下角的位置。请注意，由于历史原因，此函数返回QPoint(left(),top() +height() - 1)。

另请参见 setBottomLeft()、bottom() 和left()。

[constexpr noexcept] QPoint QRect::bottomRight() const

返回矩形右下角的位置。

请注意，由于历史原因，此函数返回QPoint(left() +width() -1,top() +height() - 1)。

另请参阅 setBottomRight()、bottom() 和right()。

[constexpr noexcept] QPoint QRect::center() const

返回矩形的中心点。

另请参阅 moveCenter()。

[noexcept] bool QRect::contains(const QPoint &point, bool proper = false) const

如果给定的point 位于矩形内部或边缘，则返回true ，否则返回false 。如果proper 为 true，则只有当给定的point 位于矩形内部（即不在矩形边缘）时，此函数才会返回true 。

另请参阅 intersects() 。

[noexcept] bool QRect::contains(const QRect &rectangle, bool proper = false) const

这是一个重载函数。

如果给定的rectangle 位于此矩形内，则返回true 。否则返回false 。如果proper 为 true，则只有当rectangle 完全位于此矩形内部（不在边缘上）时，此函数才会返回true 。

[noexcept] bool QRect::contains(int x, int y) const

这是一个重载函数。

如果点 (x,y) 在此矩形内，则返回true ，否则返回false 。

[noexcept] bool QRect::contains(int x, int y, bool proper) const

这是一个重载函数。

如果点 (x,y) 位于矩形内部或边缘，则返回true ，否则返回false 。如果proper 为 true，则只有当点完全位于矩形内部（不在边缘上）时，此函数才会返回true 。

[constexpr] void QRect::getCoords(int *x1, int *y1, int *x2, int *y2) const

提取矩形左上角的位置到 *x1 和 *y1 ，提取矩形右下角的位置到 *x2 和 *y2 。

另请参阅 setCoords() 和getRect()。

[constexpr] void QRect::getRect(int *x, int *y, int *width, int *height) const

提取矩形左上角的位置到 *x 和 *y ，其尺寸到 *width 和 *height 。

另请参阅 setRect() 和getCoords()。

[constexpr noexcept] int QRect::height() const

返回矩形的高度。

另请参阅 setHeight()、width() 和size()。

[noexcept] QRect QRect::intersected(const QRect &rectangle) const

返回此矩形与给定rectangle 的交集。请注意r.intersected(s) 等同于r & s 。

另请参阅 intersects()、united() 和operator&=()。

[noexcept] bool QRect::intersects(const QRect &rectangle) const

如果该矩形与给定的rectangle 相交（即至少有一个像素在两个矩形内），则返回true ，否则返回false 。

相交矩形可通过intersected() 函数获取。

另请参见 contains()。

[constexpr noexcept] bool QRect::isEmpty() const

如果矩形为空，则返回true ，否则返回false 。

空矩形的left() >right() 或top() >bottom() 。空矩形无效（即 isEmpty() == !isValid() ）。

使用normalized() 函数可以获取一个四角互换的矩形。

另请参阅 isNull()、isValid() 和normalized()。

[constexpr noexcept] bool QRect::isNull() const

如果矩形为空矩形，则返回true ，否则返回false 。

空矩形的宽度和高度均设置为 0（即right() ==left() - 1 和bottom() ==top() - 1）。空矩形也是空的，因此无效。

另请参阅 isEmpty() 和isValid()。

[constexpr noexcept] bool QRect::isValid() const

如果矩形有效，则返回true ，否则返回false 。

有效矩形的left() <=right() 和top() <=bottom() 。请注意，无效矩形不定义交集等非三维操作。有效的矩形不是空的（即 isValid() == !isEmpty() ）。

另请参见 isNull()、isEmpty() 和normalized()。

[constexpr noexcept] int QRect::left() const

返回矩形左边缘的 x 坐标。等价于x()。

另请参阅 setLeft()、topLeft() 和bottomLeft()。

[constexpr noexcept] QRect QRect::marginsAdded(const QMargins &margins) const

返回由margins 生长出的矩形。

另请参阅 operator+=(),marginsRemoved() 和operator-=().

[constexpr noexcept] QRect QRect::marginsRemoved(const QMargins &margins) const

从矩形中删除margins ，缩小矩形。

另请参阅 marginsAdded()、operator+=() 和operator-=()。

[constexpr noexcept] void QRect::moveBottom(int y)

垂直移动矩形，使矩形底边位于给定的y 坐标处。矩形的大小保持不变。

另请参阅 bottom()、setBottom() 和moveTop()。

[constexpr noexcept] void QRect::moveBottomLeft(const QPoint &position)

移动矩形，将左下角保留在给定的position 处。矩形的大小不变。

另请参阅 setBottomLeft()、moveBottom() 和moveLeft()。

[constexpr noexcept] void QRect::moveBottomRight(const QPoint &position)

移动矩形，将右下角留在给定的position 处。矩形的大小不变。

另请参阅 setBottomRight()、moveRight() 和moveBottom()。

[constexpr noexcept] void QRect::moveCenter(const QPoint &position)

移动矩形，将中心点留在给定的position 处。矩形的大小不变。

另请参见 center()。

[constexpr noexcept] void QRect::moveLeft(int x)

水平移动矩形，使矩形的左边缘位于给定的x 坐标处。矩形的大小保持不变。

另请参阅 left()、setLeft() 和moveRight()。

[constexpr noexcept] void QRect::moveRight(int x)

水平移动矩形，使矩形的右边缘位于给定的x 坐标处。矩形的大小保持不变。

另请参阅 right()、setRight() 和moveLeft()。

[constexpr noexcept] void QRect::moveTo(const QPoint &position)

移动矩形，将其左上角保留在给定的position 处。

[constexpr noexcept] void QRect::moveTo(int x, int y)

移动矩形，将左上角保留在指定位置 (x,y)。矩形的大小不变。

另请参阅 translate() 和moveTopLeft()。

[constexpr noexcept] void QRect::moveTop(int y)

垂直移动矩形，使矩形顶边位于给定的y 坐标处。矩形的大小保持不变。

另请参阅 top()、setTop() 和moveBottom()。

[constexpr noexcept] void QRect::moveTopLeft(const QPoint &position)

移动矩形，将左上角留在给定的position 处。矩形的大小不变。

另请参阅 setTopLeft()、moveTop() 和moveLeft()。

[constexpr noexcept] void QRect::moveTopRight(const QPoint &position)

移动矩形，将右上角留在给定的position 处。矩形的大小不变。

另请参阅 setTopRight()、moveTop() 和moveRight()。

[noexcept] QRect QRect::normalized() const

返回归一化矩形，即宽度和高度均为非负的矩形。

如果width() < 0，函数会交换左角和右角；如果height() < 0，函数会交换上角和下角。同时，角也会从非包含型变为包含型。

另请参见 isValid() 和isEmpty()。

[constexpr noexcept] int QRect::right() const

返回矩形右边缘的 x 坐标。

请注意，由于历史原因，此函数返回left() +width() - 1；使用x() +width() 可获取真正的 x 坐标。

另请参见 setRight()、topRight() 和bottomRight()。

[constexpr noexcept] void QRect::setBottom(int y)

将矩形的底边设置为给定的y 坐标。可以改变高度，但不会改变矩形的上边缘。

另请参阅 bottom() 和moveBottom()。

[constexpr noexcept] void QRect::setBottomLeft(const QPoint &position)

将矩形的左下角设置为给定的position 。可以改变矩形的大小，但不会改变矩形的右上角。

另请参阅 bottomLeft() 和moveBottomLeft()。

[constexpr noexcept] void QRect::setBottomRight(const QPoint &position)

将矩形的右下角设置为给定的position 。可更改大小，但不会更改矩形的左上角。

另请参阅 bottomRight() 和moveBottomRight()。

[constexpr noexcept] void QRect::setCoords(int x1, int y1, int x2, int y2)

将矩形左上角的坐标设置为 (x1,y1)，将矩形右下角的坐标设置为 (x2,y2)。

另请参阅 getCoords() 和setRect()。

[constexpr noexcept] void QRect::setHeight(int height)

将矩形的高度设置为给定的height 。底边会改变，但顶边不会。

另请参阅 height() 和setSize()。

[constexpr noexcept] void QRect::setLeft(int x)

将矩形的左边缘设置为给定的x 坐标。可以改变宽度，但不会改变矩形的右边缘。

等同于setX()。

另请参阅 left() 和moveLeft()。

[constexpr noexcept] void QRect::setRect(int x, int y, int width, int height)

将矩形左上角的坐标设置为 (x,y) ，并将其大小设置为给定的width 和height 。

另请参阅 getRect() 和setCoords()。

[constexpr noexcept] void QRect::setRight(int x)

将矩形的右边缘设置为给定的x 坐标。可以改变宽度，但不会改变矩形的左边缘。

另请参阅 right() 和moveRight()。

[constexpr noexcept] void QRect::setSize(const QSize &size)

将矩形的大小设置为给定的size 。左上角不会移动。

另请参阅 size()、setWidth() 和setHeight()。

[constexpr noexcept] void QRect::setTop(int y)

将矩形的顶边设置为给定的y 坐标。可以改变高度，但不会改变矩形的底边。

等同于setY()。

另请参阅 top() 和moveTop()。

[constexpr noexcept] void QRect::setTopLeft(const QPoint &position)

将矩形的左上角设置为给定的position 。可以改变矩形的大小，但不会改变矩形的右下角。

另请参阅 topLeft() 和moveTopLeft()。

[constexpr noexcept] void QRect::setTopRight(const QPoint &position)

将矩形的右上角设置为给定的position 。可更改大小，但不会更改矩形的左下角。

另请参阅 topRight() 和moveTopRight()。

[constexpr noexcept] void QRect::setWidth(int width)

将矩形的宽度设置为给定的width 。右边会改变，但左边不会。

另请参阅 width() 和setSize()。

[constexpr noexcept] void QRect::setX(int x)

将矩形的左边缘设置为给定的x 坐标。可以改变宽度，但不会改变矩形的右边缘。

等同于setLeft()。

另请参阅 x(),setY() 和setTopLeft()。

[constexpr noexcept] void QRect::setY(int y)

将矩形的顶边设置为给定的y 坐标。可以改变高度，但不会改变矩形的底边。

等同于setTop()。

另请参阅 y(),setX() 和setTopLeft()。

[constexpr noexcept] QSize QRect::size() const

返回矩形的大小。

另请参阅 setSize()、width() 和height()。

[static constexpr noexcept, since 6.0] QRect QRect::span(const QPoint &p1, const QPoint &p2)

返回一个跨p1 和p2 两点的矩形，包括这两点及两点之间的所有内容。

此函数在 Qt 6.0 中引入。

[noexcept] CGRect QRect::toCGRect() const

从QRect 创建 CGRect。

另请参阅 QRectF::fromCGRect().

[constexpr noexcept, since 6.4] QRectF QRect::toRectF() const

将此矩形返回为具有浮点精度的矩形。

此函数在 Qt 6.4 中引入。

另请参阅 QRectF::toRect() 。

[constexpr noexcept] int QRect::top() const

返回矩形顶边的 y 坐标。等价于y()。

另请参阅 setTop()、topLeft() 和topRight()。

[constexpr noexcept] QPoint QRect::topLeft() const

返回矩形左上角的位置。

另请参阅 setTopLeft()、top() 和left()。

[constexpr noexcept] QPoint QRect::topRight() const

返回矩形右上角的位置。

请注意，由于历史原因，此函数返回QPoint(left() +width() -1,top()).

另请参阅 setTopRight()、top() 和right()。

[constexpr noexcept] void QRect::translate(int dx, int dy)

相对于当前位置，沿 x 轴移动矩形dx ，沿 y 轴移动矩形dy 。正值会使矩形向右和向下移动。

另请参阅 moveTopLeft()、moveTo() 和translated()。

[constexpr noexcept] void QRect::translate(const QPoint &offset)

这是一个重载函数。

相对于当前位置，沿 x 轴移动矩形offset.x() ，沿 y 轴移动矩形offset.y() 。

[constexpr noexcept] QRect QRect::translated(int dx, int dy) const

返回相对于当前位置沿 x 轴平移dx 和沿 y 轴平移dy 的矩形副本。正值会使矩形向右和向下移动。

另请参见 translate()。

[constexpr noexcept] QRect QRect::translated(const QPoint &offset) const

这是一个重载函数。

返回相对于当前位置沿 x 轴平移offset.x() 和沿 y 轴平移offset.y() 后的矩形副本。

[constexpr noexcept] QRect QRect::transposed() const

返回改变了宽度和高度的矩形副本：

QRect r = {15, 51, 42, 24};
r = r.transposed(); // r == {15, 51, 24, 42}

另请参见 QSize::transposed()。

[noexcept] QRect QRect::united(const QRect &rectangle) const

返回此矩形与给定rectangle 的边界矩形。

另请参见 intersected()。

[constexpr noexcept] int QRect::width() const

返回矩形的宽度。

另请参阅 setWidth()、height() 和size()。

[constexpr noexcept] int QRect::x() const

返回矩形左边缘的 x 坐标。等价于left()。

另请参阅 setX()、y() 和topLeft()。

[constexpr noexcept] int QRect::y() const

返回矩形顶边的 y 坐标。等价于top()。

另请参阅 setY()、x() 和topLeft()。

[noexcept] QRect QRect::operator&(const QRect &rectangle) const

返回此矩形与给定rectangle 的交集。如果没有交集，则返回空矩形。

另请参阅 operator&=() 和intersected()。

[noexcept] QRect &QRect::operator&=(const QRect &rectangle)

与给定的rectangle 相交。

另请参见 intersected() 和operator&()。

[constexpr noexcept] QRect &QRect::operator+=(const QMargins &margins)

将margins 添加到矩形中，使其增长。

另请参阅 marginsAdded()、marginsRemoved() 和operator-=()。

[constexpr noexcept] QRect &QRect::operator-=(const QMargins &margins)

返回按margins 缩小的矩形。

另请参见 marginsRemoved()、operator+=() 和marginsAdded()。

[noexcept] QRect QRect::operator|(const QRect &rectangle) const

返回此矩形与给定rectangle 的边界矩形。

另请参阅 operator|=() 和united()。

[noexcept] QRect &QRect::operator|=(const QRect &rectangle)

将此矩形与给定的rectangle 相结合。

另请参阅 united() 和operator|()。