QRect 类

成员函数文档

[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)

构造一个矩形，其左上角为(i, 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为真，则此函数仅在指定的点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，则此函数仅当点完全位于矩形内（不在边界上时）才返回 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。

一个空矩形有左() > 右() 或 上() > 下(). 空矩形是无效的（即，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。

有效矩形的左() <= 右() 和 上() <= 下(). 注意，对于无效矩形，未定义非平凡操作，如交集。有效矩形不是空的（即，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(int x, int y)

移动矩形，使矩形的左上角位于给定的位置 (x, y)。矩形的尺寸保持不变。

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

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

移动矩形，使矩形的左上角位于给定的 position。

[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)

将矩形左上角设置为指定的 位置。可能改变大小，但永远不会改变矩形的右下角。

参见topLeft() 和 moveTopLeft。

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

将矩形右上角设置为指定的 位置。可能改变大小，但永远不会改变矩形的左下角。

参见topRight() 和 moveTopRight。

[constexpr noexcept] void QRect::setWidth(int 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|。