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 坐标，请使用 `y()` + `height()`。

另请参阅 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 为真，则该函数仅在给定的point 位于矩形内部（即不在边上）时才返回true 。

另请参阅 intersects()。

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

如果给定的rectangle 位于该矩形内部，则返回true ；否则返回false 。如果proper 为真，则只有当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 。

[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 坐标，请使用x() +width()。

另请参阅 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)

将矩形offset 、x()沿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|()。