成员函数文档

Rect::Rect(Qul::PlatformInterface::coord_t x, Qul::PlatformInterface::coord_t y, Qul::PlatformInterface::coord_t width, Qul::PlatformInterface::coord_t height)

使用(x, y)作为其左上角以及给定的width和height构造一个矩形。

另请参阅setRect。

Rect::Rect(const Qul::PlatformInterface::Point &topLeft, const Qul::PlatformInterface::Size &size)

使用给定的topLeft角落和给定的size构造一个矩形。

另请参阅setTopLeft()和setSize。

Rect::Rect(const Qul::PlatformInterface::Point &topLeft, const Qul::PlatformInterface::Point &bottomRight)

使用给定的topLeft和bottomRight角落构造一个矩形。

另请参阅setTopLeft()和setBottomRight。

Rect::Rect()

构造一个空矩形。

另请参阅setRect()和isNull。

void Rect::adjust(Qul::PlatformInterface::coord_t x1, Qul::PlatformInterface::coord_t y1, Qul::PlatformInterface::coord_t x2, Qul::PlatformInterface::coord_t y2)

将x1、y1、x2和y2分别添加到矩形现有的坐标中。

另请参阅adjusted()和setRect。

Qul::PlatformInterface::Rect Rect::adjusted(Qul::PlatformInterface::coord_t x1, Qul::PlatformInterface::coord_t y1, Qul::PlatformInterface::coord_t x2, Qul::PlatformInterface::coord_t y2) const

返回一个新的矩形，其中分别将 x1、y1、x2和y2添加到现有坐标中。

另请参阅adjust。

Qul::PlatformInterface::coord_t Rect::底部() const

返回矩形的底部边的y坐标。

注意，为了与Qt兼容，此函数返回top() + height() - 1；使用y() + height来获取真实的y坐标。

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

Qul::PlatformInterface::Point Rect::bottomLeft() const

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

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

Qul::PlatformInterface::Point Rect::bottomRight() const

返回矩形的右下角的位置。

注意，为了与Qt兼容，此函数返回Point(left() + width() -1, top() + height() - 1)。

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

Qul::PlatformInterface::Point Rect::center() const

返回矩形的中心点。

另请参见moveCenter。

bool Rect::contains(const Qul::PlatformInterface::Rect &rectangle, bool proper = false) const

这是一个重载函数。

如果给定的rectangle在此矩形内，则返回true，否则返回false。如果proper为真，此函数仅在矩形内（不在边缘上）时返回true。

bool Rect::contains(const Qul::PlatformInterface::Point &point, bool proper = false) const

这是一个重载函数。

如果给定的point在矩形内或边缘上，则返回true，否则返回false。如果proper为真，此函数仅在给定point位于矩形内时返回true(即不在边缘上)。

另请参见intersects。

bool Rect::contains(Qul::PlatformInterface::coord_t x, Qul::PlatformInterface::coord_t y) const

这是一个重载函数。

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

bool Rect::contains(Qul::PlatformInterface::coord_t x, Qul::PlatformInterface::coord_t y, bool proper) const

这是一个重载函数。

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

void Rect::getCoords(Qul::PlatformInterface::coord_t *x1, Qul::PlatformInterface::coord_t *y1, Qul::PlatformInterface::coord_t *x2, Qul::PlatformInterface::coord_t *y2) const

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

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

void Rect::getRect(Qul::PlatformInterface::coord_t *x, Qul::PlatformInterface::coord_t *y, Qul::PlatformInterface::coord_t *width, Qul::PlatformInterface::coord_t *height) const

将矩形左上角的位置提取到 *x 和 *y，并将其大小提取到 *width 和 *height。

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

Qul::PlatformInterface::coord_t Rect::height() const

返回矩形的宽度。

另请参阅setHeight()，width() 和 size().

Qul::PlatformInterface::Rect Rect::intersected(const Qul::PlatformInterface::Rect &rectangle) const

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

另请参阅intersects()，united() 和 operator&=().

bool Rect::intersects(const Qul::PlatformInterface::Rect &rectangle) const

如果此矩形与给定的 rectangle 交叉（即，两个矩形中至少有一个像素位于其中），则返回 true，否则返回 false。

可以使用 intersected() 函数检索交集矩形。

另请参阅contains().

bool Rect::isEmpty() const

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

一个空矩形具有 左边界() > 右边界() 或 顶边界() > 底边界(). 空矩形无效（即 isEmpty() == !isValid()).

使用 normalized() 函数来获取一个角落交换的矩形。

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

bool Rect::isNull() const

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

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

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

bool Rect::isValid() const

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

有效的矩形有 左边界() <= 右边界() 和 顶边界() <= 底边界(). 请注意，对于非平凡操作，如交集，在无效矩形上没有定义。有效的矩形不是空矩形（即 isValid() == !isEmpty()).

另请参阅isNull()，isEmpty() 和 normalized()。

Qul::PlatformInterface::coord_t Rect::left() const

返回矩形左边界的 x 坐标。等同于 x().

另请参阅setLeft()，topLeft() 和 bottomLeft().

void Rect::moveBottom(Qul::PlatformInterface::coord_t y)

垂直移动矩形，使矩形的底边界位于给定的 y 坐标。矩形的尺寸保持不变。

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

void Rect::moveBottomLeft(const Qul::PlatformInterface::Point &position)

移动矩形，使左下角位于给定的 position。矩形的尺寸保持不变。

另请参阅setBottomLeft()，moveBottom() 和 moveLeft().

void Rect::moveBottomRight(const Qul::PlatformInterface::Point &position)

移动矩形，使右下角位于给定的 position。矩形的尺寸保持不变。

另请参阅setBottomRight()，moveRight() 和 moveBottom().

void Rect::moveCenter(const Qul::PlatformInterface::Point &position)

移动矩形，保持中心点在给定的 Position 处。矩形的尺寸保持不变。

另请参阅center。

void Rect::moveLeft(Qul::PlatformInterface::coord_t x)

水平移动矩形，将矩形的左边保持在与给定的 x 坐标一致的位置。矩形的尺寸保持不变。

另请参阅left，setLeft 和 moveRight。

void Rect::moveRight(Qul::PlatformInterface::coord_t x)

水平移动矩形，将矩形的右边保持在与给定的 x 坐标一致的位置。矩形的尺寸保持不变。

另请参阅right，setRight 和 moveLeft。

void Rect::moveTo(Qul::PlatformInterface::coord_t x, Qul::PlatformInterface::coord_t y)

这是一个重载函数。

移动矩形，保持左上角在给定的位置（x，y）。矩形的尺寸保持不变。

另请参阅translate 和 moveTopLeft。

void Rect::moveTo(const Qul::PlatformInterface::Point &position)

这是一个重载函数。

移动矩形，保持左上角在给定的 Position。

void Rect::moveTop(Qul::PlatformInterface::coord_t y)

垂直移动矩形，将矩形的顶部保持在与给定的 y 坐标一致的位置。矩形的尺寸保持不变。

另请参阅top，setTop 和 moveBottom。

void Rect::moveTopLeft(const Qul::PlatformInterface::Point &position)

移动矩形，保持左上角在给定的 Position。矩形的尺寸保持不变。

另请参阅setTopLeft，moveTop 和 moveLeft。

void Rect::moveTopRight(const Qul::PlatformInterface::Point &position)

移动矩形，保持右上角在给定的 Position。矩形的尺寸保持不变。

另请参阅setTopRight，moveTop 和 moveRight。

Qul::PlatformInterface::Rect Rect::normalized() const

返回正常化的矩形，即具有非负宽度和高度的矩形。

如果 width() < 0，则函数会交换左右顶点，如果 height() < 0，则还会交换上下顶点。

另请参阅 isValid() 和 isEmpty。

Qul::PlatformInterface::coord_t Rect::right() const

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

注意，为了与 Qt 兼容，此函数返回 left() + width() - 1；请使用 x() + width 来获取真实的 x 坐标。

另请参阅 setRight()，topRight 和 bottomRight。

void Rect::setBottom(Qul::PlatformInterface::coord_t y)

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

另请参阅 bottom() 和 moveBottom。

void Rect::setBottomLeft(const Qul::PlatformInterface::Point &position)

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

另请参阅 bottomLeft() 和 moveBottomLeft。

void Rect::setBottomRight(const Qul::PlatformInterface::Point &position)

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

另请参阅 bottomRight() 和 moveBottomRight。

void Rect::setCoords(Qul::PlatformInterface::coord_t x1, Qul::PlatformInterface::coord_t y1, Qul::PlatformInterface::coord_t x2, Qul::PlatformInterface::coord_t y2)

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

另请参阅 getCoords() 和 setRect。

void Rect::setHeight(Qul::PlatformInterface::coord_t height)

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

另请参阅 height() 和 setSize。

void Rect::setLeft(Qul::PlatformInterface::coord_t x)

将矩形的左侧边设为给定的 x 坐标。可能会改变宽度，但永远不会改变矩形的右侧边。

等同于 setX。

另请参阅 left() 和 moveLeft。

void Rect::setRect(Qul::PlatformInterface::coord_t x, Qul::PlatformInterface::coord_t y, Qul::PlatformInterface::coord_t width, Qul::PlatformInterface::coord_t height)

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

另请参阅getRect() 和 setCoords。

void Rect::setRight(Qul::PlatformInterface::coord_t x)

将矩形右边界设置为给定的 x 坐标。可能会更改宽度，但永远不会更改左边界。

另请参阅right() 和 moveRight。

void Rect::setSize(const Qul::PlatformInterface::Size &size)

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

另请参阅size，setWidth 和 setHeight。

void Rect::setTop(Qul::PlatformInterface::coord_t y)

将矩形的上边界设置为给定的 y 坐标。可能会更改高度，但永远不会更改下边界。

等价于 setY。

另请参阅top 和 moveTop。

void Rect::setTopLeft(const Qul::PlatformInterface::Point &position)

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

另请参阅topLeft 和 moveTopLeft。

void Rect::setTopRight(const Qul::PlatformInterface::Point &position)

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

另请参阅topRight 和 moveTopRight。

void Rect::setWidth(Qul::PlatformInterface::coord_t width)

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

另请参阅width 和 setSize。

void Rect::setX(Qul::PlatformInterface::coord_t x)

将矩形的左侧边设为给定的 x 坐标。可能会改变宽度，但永远不会改变矩形的右侧边。

等价于 setLeft。

另请参阅x，setY 和 setTopLeft。

void Rect::setY(Qul::PlatformInterface::coord_t y)

将矩形的上边界设置为给定的 y 坐标。可能会更改高度，但永远不会更改下边界。

等价于 setTop。

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

Qul::PlatformInterface::Size Rect::size() const

返回矩形的尺寸。

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

Qul::PlatformInterface::coord_t Rect::top() const

返回矩形顶部边的y坐标。相当于y。

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

Qul::PlatformInterface::Point Rect::topLeft() const

返回矩形左上角的位置。

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

Qul::PlatformInterface::Point Rect::topRight() const

返回矩形右上角的位置。

注意，为了与Qt兼容，该函数返回Point(left() + width() -1, top()).

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

void Rect::translate(Qul::PlatformInterface::coord_t dx, Qul::PlatformInterface::coord_t dy)

这是一个重载函数。

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

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

void Rect::translate(const Qul::PlatformInterface::Point &offset)

这是一个重载函数。

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

Qul::PlatformInterface::Rect Rect::translated(Qul::PlatformInterface::coord_t dx, Qul::PlatformInterface::coord_t dy) const

这是一个重载函数。

返回一个矩形的拷贝，该矩形相对于当前位置沿x轴移动dx，沿y轴移动dy。正值将矩形向右和向下移动。

另请参阅 translate()。

Qul::PlatformInterface::Rect Rect::translated(const Qul::PlatformInterface::Point &offset) const

这是一个重载函数。

返回一个通过 偏移.x() 沿x轴和 偏移.y() 沿y轴平移的矩形副本，相对当前位置。

另请参阅 translate()。

Qul::PlatformInterface::Rect Rect::transposed() const

返回一个其宽度和高度交换的矩形副本。

参阅Qul::PlatformInterface::Size::transposed。

Qul::PlatformInterface::Rect Rect::united(const Qul::PlatformInterface::Rect &rectangle) const

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

参阅intersected。

Qul::PlatformInterface::coord_t Rect::width() const

返回矩形的宽度。

参阅setWidth()，height() 和 size。

Qul::PlatformInterface::coord_t Rect::x() const

返回矩形左侧边的 x 坐标。相当于 left。

参阅setX()，y() 和 topLeft。

Qul::PlatformInterface::coord_t Rect::y() const

返回矩形顶边的 y 坐标。相当于 top。

参阅setY()，x 和 topLeft。

Qul::PlatformInterface::Rect Rect::operator&(const Qul::PlatformInterface::Rect &rectangle) const

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

参阅operator&=() 和 intersected。

Qul::PlatformInterface::Rect &Rect::operator&=(const Qul::PlatformInterface::Rect &rectangle)

与此矩形与给定 rectangle 交集。

参阅intersected() 和 operator&。

Qul::PlatformInterface::Rect Rect::operator|(const Qul::PlatformInterface::Rect &rectangle) const

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

参阅operator|=() 和 united。

Qul::PlatformInterface::Rect &Rect::operator|(const Qul::PlatformInterface::Rect &rectangle)

与此矩形与给定 rectangle 合并。

另请参阅 united() 和 operator|