QRectF Class

成员函数文档

[constexpr noexcept] QRectF::QRectF()

构建一个空矩形。

另请参阅 isNull()。

[constexpr noexcept] QRectF::QRectF(const QRect &rectangle)

根据给定的QRect rectangle 创建一个 QRectF 矩形。

另请参阅 toRect() 和QRect::toRectF()。

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QPointF &bottomRight)

根据给定的topLeft 和bottomRight 构建一个矩形。

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

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QSizeF &size)

根据给定的topLeft 角和size ，构造一个矩形。

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

[constexpr noexcept] QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)

构造一个矩形，其左上角坐标为 (x,y)，边长分别为给定的width 和height 。所有参数必须是有限的。

另请参阅 setRect()。

[constexpr noexcept] void QRectF::adjust(qreal dx1, qreal dy1, qreal dx2, qreal dy2)

分别将dx1 、dy1 、dx2 和dy2 添加到矩形的现有坐标中。所有参数必须为有限值。

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

[constexpr noexcept] QRectF QRectF::adjusted(qreal dx1, qreal dy1, qreal dx2, qreal dy2) const

返回一个新的矩形，该矩形的坐标在现有坐标基础上分别增加了dx1 、dy1 、dx2 和dy2 。所有参数必须为有限值。

另请参阅 adjust()。

[constexpr noexcept] qreal QRectF::bottom() const

返回矩形底边的 y 坐标。

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

[constexpr noexcept] QPointF QRectF::bottomLeft() const

返回矩形左下角的位置。

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

[constexpr noexcept] QPointF QRectF::bottomRight() const

返回矩形右下角的位置。

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

[constexpr noexcept] QPointF QRectF::center() const

返回矩形的中心点。

另请参阅 moveCenter()。

[noexcept] bool QRectF::contains(const QPointF &point) const

如果给定的point 位于矩形内部或位于矩形边界上，则返回true ；否则返回false 。

另请参阅 intersects()。

[noexcept] bool QRectF::contains(const QRectF &rectangle) const

如果给定的rectangle 位于该矩形内部，则返回true ；否则返回false 。

[noexcept] bool QRectF::contains(qreal x, qreal y) const

如果点 (x,y) 位于矩形内部或其边界上，则返回true ；否则返回false 。

[static noexcept] QRectF QRectF::fromCGRect(CGRect rect)

根据 CGRectrect 创建一个QRectF 。

另请参阅 toCGRect()。

[static, since 6.5] QRectF QRectF::fromDOMRect(emscripten::val domRect)

将 DOMRect（https://www.w3.org/TR/geometry-1/）domRect 转换为QRectF 。如果提供的参数不是 DOMRect，则行为未定义。

该函数在 Qt 6.5 中引入。

另请参阅 toDOMRect()。

[constexpr] void QRectF::getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *y2) const

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

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

[constexpr] void QRectF::getRect(qreal *x, qreal *y, qreal *width, qreal *height) const

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

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

[constexpr noexcept] qreal QRectF::height() const

返回矩形的高度。

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

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

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

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

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

如果该矩形与给定的rectangle 相交（即它们之间存在非空的重叠区域），则返回true ；否则返回false 。

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

另请参阅 contains()。

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

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

空矩形的width() <= 0 或height() <= 0。空矩形无效（即 isEmpty() == !isValid()）。

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

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

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

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

空矩形的宽度和高度均设置为 0。空矩形也是空的，因此无效。

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

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

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

一个有效的矩形满足width() > 0 且height() > 0。请注意，对于无效的矩形，交集等非平凡操作未被定义。有效的矩形不为空（即 isValid() == !isEmpty()）。

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

[constexpr noexcept] qreal QRectF::left() const

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

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

[constexpr noexcept] QRectF QRectF::marginsAdded(const QMarginsF &margins) const

返回一个通过margins 缩放后的矩形。

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

[constexpr noexcept] QRectF QRectF::marginsRemoved(const QMarginsF &margins) const

从矩形中移除margins ，使其缩小。

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

[constexpr noexcept] void QRectF::moveBottom(qreal y)

将矩形沿垂直方向移动，同时保持矩形的下边缘位于给定的有限y 坐标处。矩形的大小保持不变。

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

[constexpr noexcept] void QRectF::moveBottomLeft(const QPointF &position)

将矩形移动，使其左下角位于给定的坐标position 处。矩形的大小保持不变。

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

[constexpr noexcept] void QRectF::moveBottomRight(const QPointF &position)

将矩形移动，使其右下角位于指定的坐标position 处。矩形的大小保持不变。

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

[constexpr noexcept] void QRectF::moveCenter(const QPointF &position)

将矩形移动，使其中心点位于给定的坐标position 处。矩形的大小保持不变。

另请参阅 center()。

[constexpr noexcept] void QRectF::moveLeft(qreal x)

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

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

[constexpr noexcept] void QRectF::moveRight(qreal x)

将矩形水平移动，使其右边缘保持在给定的有限x 坐标处。矩形的大小保持不变。

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

[constexpr noexcept] void QRectF::moveTo(qreal x, qreal y)

将矩形移动，同时保持其左上角位于给定位置（x ，y ）。矩形的大小保持不变。这两个参数必须均为有限值。

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

[constexpr noexcept] void QRectF::moveTo(const QPointF &position)

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

[constexpr noexcept] void QRectF::moveTop(qreal y)

将矩形沿垂直方向移动，使矩形的上边位于给定的有限坐标y 处。矩形的大小保持不变。

另请参阅 top()、setTop() 以及moveBottom()。

[constexpr noexcept] void QRectF::moveTopLeft(const QPointF &position)

将矩形移动，使其左上角位于给定的position 处。矩形的大小保持不变。

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

[constexpr noexcept] void QRectF::moveTopRight(const QPointF &position)

将矩形移动，使其右上角位于给定的position 处。矩形的大小保持不变。

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

[noexcept] QRectF QRectF::normalized() const

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

如果 `width()` < 0，该函数会交换左右两角的位置；如果 `height()` < 0，则交换上下两角的位置。

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

[constexpr noexcept] qreal QRectF::right() const

返回矩形右边的 x 坐标。

另请参阅 setRight()、topRight()，以及bottomRight()。

[constexpr noexcept] void QRectF::setBottom(qreal y)

将矩形的下边缘设置为给定的有限坐标y 。可能会改变高度，但绝不会改变矩形的上边缘。

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

[constexpr noexcept] void QRectF::setBottomLeft(const QPointF &position)

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

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

[constexpr noexcept] void QRectF::setBottomRight(const QPointF &position)

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

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

[constexpr noexcept] void QRectF::setCoords(qreal x1, qreal y1, qreal x2, qreal y2)

将矩形左上角的坐标设置为 (x1,y1)，将其右下角的坐标设置为 (x2,y2)。所有参数必须为有限值。

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

[constexpr noexcept] void QRectF::setHeight(qreal height)

将矩形的高度设置为给定的有限值height 。底部边会发生变化，但顶部边保持不变。

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

[constexpr noexcept] void QRectF::setLeft(qreal x)

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

等同于setX()。

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

[constexpr noexcept] void QRectF::setRect(qreal x, qreal y, qreal width, qreal height)

将矩形左上角的坐标设置为 (x,y)，并将矩形大小设置为给定的width 和height 。所有参数必须为有限值。

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

[constexpr noexcept] void QRectF::setRight(qreal x)

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

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

[constexpr noexcept] void QRectF::setSize(const QSizeF &size)

将矩形的大小设置为给定的有限值size 。左上角位置不变。

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

[constexpr noexcept] void QRectF::setTop(qreal y)

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

等同于setY()。

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

[constexpr noexcept] void QRectF::setTopLeft(const QPointF &position)

将矩形的左上角设置为给定的position 。可能会改变尺寸，但绝不会改变矩形的右下角。

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

[constexpr noexcept] void QRectF::setTopRight(const QPointF &position)

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

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

[constexpr noexcept] void QRectF::setWidth(qreal width)

将矩形的宽度设置为给定的有限值width 。右边缘会发生变化，但左边缘保持不变。

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

[constexpr noexcept] void QRectF::setX(qreal x)

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

等同于setLeft()。

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

[constexpr noexcept] void QRectF::setY(qreal y)

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

等同于setTop()。

另请参阅 y()、setX() 以及setTopLeft()。

[constexpr noexcept] QSizeF QRectF::size() const

返回矩形的大小。

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

[noexcept] QRect QRectF::toAlignedRect() const

根据该矩形的值，返回一个QRect ，该矩形是能够完全包含该矩形且尺寸尽可能小的整数矩形。

另请参阅 toRect()。

[noexcept] CGRect QRectF::toCGRect() const

根据QRectF 创建一个CGRect。

另请参阅 fromCGRect()。

[since 6.5] emscripten::val QRectF::toDOMRect() const

将此对象转换为 DOMRect（https://www.w3.org/TR/geometry-1/）。

该函数在 Qt 6.5 中引入。

另请参阅 fromDOMRect()。

[constexpr noexcept] QRect QRectF::toRect() const

根据该矩形的值返回一个 `QRect ` 对象。请注意，返回的矩形中的坐标会四舍五入到最接近的整数。

另请参阅 QRectF()、toAlignedRect() 和QRect::toRectF()。

[constexpr noexcept] qreal QRectF::top() const

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

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

[constexpr noexcept] QPointF QRectF::topLeft() const

返回矩形左上角的位置。

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

[constexpr noexcept] QPointF QRectF::topRight() const

返回矩形右上角的位置。

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

[constexpr noexcept] void QRectF::translate(qreal dx, qreal dy)

将矩形沿 x 轴移动dx ，沿 y 轴移动dy ，以当前位置为基准。正值表示将矩形向右下方移动。这两个参数必须为有限值。

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

[constexpr noexcept] void QRectF::translate(const QPointF &offset)

将矩形offset 、x()沿x轴移动，并沿y轴offset 、y()移动，以当前位置为基准。

[constexpr noexcept] QRectF QRectF::translated(qreal dx, qreal dy) const

返回一个矩形的副本，该矩形相对于当前位置沿 x 轴平移dx ，沿 y 轴平移dy 。正值会将矩形向右和向下移动。这两个参数必须是有限值。

另请参阅 translate()。

[constexpr noexcept] QRectF QRectF::translated(const QPointF &offset) const

返回一个矩形的副本，该矩形相对于当前位置沿 x 轴平移了offset 。x()，沿 y 轴平移了offset 。y()。

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

返回一个矩形的副本，其宽度和高度已被互换：

QRectF r = {1.5, 5.1, 4.2, 2.4};
r = r.transposed(); // r == {1.5, 5.1, 2.4, 4.2}

另请参阅 ` QSizeF::transposed()`。

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

返回该矩形与给定的rectangle 构成的边界矩形。

另请参阅 intersected()。

[constexpr noexcept] qreal QRectF::width() const

返回矩形的宽度。

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

[constexpr noexcept] qreal QRectF::x() const

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

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

[constexpr noexcept] qreal QRectF::y() const

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

另请参阅 setY()、x() 以及topLeft()。

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

返回该矩形与给定的rectangle 的交集。若无交集，则返回一个空矩形。

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

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

计算该矩形与给定rectangle 的交集。

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

[constexpr noexcept] QRectF &QRectF::operator+=(const QMarginsF &margins)

将margins 添加到矩形中，并使矩形变大。

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

[constexpr noexcept] QRectF &QRectF::operator-=(const QMarginsF &margins)

返回一个经过margins 缩放后的矩形。

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

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

返回该矩形与给定rectangle 的包围矩形。

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

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

将此矩形与给定的rectangle 合并。

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