QRectF 类使用浮点精度定义有限平面矩形。 更多...
头: | #include <QRectF> |
CMake: |
find_package(Qt6 COMPONENTS Core REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
注意: 此类的所有函数 可重入 .
QRectF (const QRect & rectangle ) | |
QRectF (qreal x , qreal y , qreal width , qreal height ) | |
QRectF (const QPointF & topLeft , const QPointF & bottomRight ) | |
QRectF (const QPointF & topLeft , const QSizeF & size ) | |
QRectF () | |
void | adjust (qreal dx1 , qreal dy1 , qreal dx2 , qreal dy2 ) |
QRectF | adjusted (qreal dx1 , qreal dy1 , qreal dx2 , qreal dy2 ) const |
qreal | bottom () const |
QPointF | bottomLeft () const |
QPointF | bottomRight () const |
QPointF | center () const |
bool | contains (const QPointF & point ) const |
bool | contains (const QRectF & rectangle ) const |
bool | contains (qreal x , qreal y ) const |
void | getCoords (qreal * x1 , qreal * y1 , qreal * x2 , qreal * y2 ) const |
void | getRect (qreal * x , qreal * y , qreal * width , qreal * height ) const |
qreal | height () const |
QRectF | intersected (const QRectF & rectangle ) const |
bool | intersects (const QRectF & rectangle ) const |
bool | isEmpty () const |
bool | isNull () const |
bool | isValid () const |
qreal | left () const |
QRectF | marginsAdded (const QMarginsF & margins ) const |
QRectF | marginsRemoved (const QMarginsF & margins ) const |
void | moveBottom (qreal y ) |
void | moveBottomLeft (const QPointF & position ) |
void | moveBottomRight (const QPointF & position ) |
void | moveCenter (const QPointF & position ) |
void | moveLeft (qreal x ) |
void | moveRight (qreal x ) |
void | moveTo (qreal x , qreal y ) |
void | moveTo (const QPointF & position ) |
void | moveTop (qreal y ) |
void | moveTopLeft (const QPointF & position ) |
void | moveTopRight (const QPointF & position ) |
QRectF | normalized () const |
qreal | right () const |
void | setBottom (qreal y ) |
void | setBottomLeft (const QPointF & position ) |
void | setBottomRight (const QPointF & position ) |
void | setCoords (qreal x1 , qreal y1 , qreal x2 , qreal y2 ) |
void | setHeight (qreal height ) |
void | setLeft (qreal x ) |
void | setRect (qreal x , qreal y , qreal width , qreal height ) |
void | setRight (qreal x ) |
void | setSize (const QSizeF & size ) |
void | setTop (qreal y ) |
void | setTopLeft (const QPointF & position ) |
void | setTopRight (const QPointF & position ) |
void | setWidth (qreal width ) |
void | setX (qreal x ) |
void | setY (qreal y ) |
QSizeF | size () const |
QRect | toAlignedRect () const |
CGRect | toCGRect () const |
QRect | toRect () const |
qreal | top () const |
QPointF | topLeft () const |
QPointF | topRight () const |
void | translate (qreal dx , qreal dy ) |
void | translate (const QPointF & offset ) |
QRectF | translated (qreal dx , qreal dy ) const |
QRectF | translated (const QPointF & offset ) const |
QRectF | transposed () const |
QRectF | united (const QRectF & rectangle ) const |
qreal | width () const |
qreal | x () const |
qreal | y () const |
QRectF | operator& (const QRectF & rectangle ) const |
QRectF & | operator&= (const QRectF & rectangle ) |
QRectF & | operator+= (const QMarginsF & margins ) |
QRectF & | operator-= (const QMarginsF & margins ) |
QRectF | operator| (const QRectF & rectangle ) const |
QRectF & | operator|= (const QRectF & rectangle ) |
QRectF | fromCGRect (CGRect rect ) |
bool | operator!= (const QRectF & r1 , const QRectF & r2 ) |
QRectF | operator+ (const QRectF & lhs , const QMarginsF & rhs ) |
QRectF | operator+ (const QMarginsF & lhs , const QRectF & rhs ) |
QRectF | operator- (const QRectF & lhs , const QMarginsF & rhs ) |
QDataStream & | operator<< (QDataStream & stream , const QRectF & rectangle ) |
bool | operator== (const QRectF & r1 , const QRectF & r2 ) |
QDataStream & | operator>> (QDataStream & stream , QRectF & rectangle ) |
矩形通常以左上角和大小形式表达。大小 (宽度和高度) 对于 QRectF 始终相当于形成其渲染基础的数学矩形。
QRectF 可以按一组左、上、宽度和高度坐标构造,或从 QPointF 和 QSizeF 。以下代码创建 2 个恒等矩形。
QRectF r1(100.0, 200.1, 11.2, 16.3); QRectF r2(QPointF(100.0, 200.1), QSizeF(11.2, 16.3));
还有第 3 个构造函数创建 QRectF 从 QRect ,且相应 toRect () 函数返回 QRect 对象基于此矩形值 (注意:返回矩形的坐标会被四舍五入到最近整数)。
The QRectF class provides a collection of functions that return the various rectangle coordinates, and enable manipulation of these. QRectF also provides functions to move the rectangle relative to the various coordinates. In addition there is a moveTo () 函数移动矩形,使其左上角留在给定坐标处。另外, translate () 函数相对当前位置将矩形移动给定偏移,和 translated () 函数返回此矩形的翻译副本。
size () 函数返回矩形的尺度按 QSizeF 。还可以单独检索尺度使用 width () 和 height () 函数。要操纵维度使用 setSize (), setWidth () 或 setHeight () 函数。另外,通过应用设置矩形坐标的函数可以改变大小,例如 setBottom () 或 setRight ().
contains
() 函数告诉给定点是否在矩形内,和
intersects
() 函数返回
true
if this rectangle intersects with a given rectangle (otherwise false). The QRectF class also provides the
intersected
() 函数返回交集矩形,和
united
() 函数返回包围给定矩形的矩形,如下所示:
![]() |
![]() |
intersected () | united () |
isEmpty
() 函数返回
true
若矩形的宽度或高度小于或等于 0。注意,空矩形无效:
isValid
() 函数返回
true
若宽度和高度两者大于 0。null 矩形 (
isNull
() == true) 另一方面,有将宽度和高度两者设为 0。
注意,由于方式有关 QRect and QRectF are defined, an empty QRectF is defined in essentially the same way as QRect .
Finally, QRectF objects can be streamed as well as compared.
当使用 anti-aliased painter, the boundary line of a QRectF will be rendered symmetrically on both sides of the mathematical rectangle's boundary line. But when using an aliased painter (the default) other rules apply.
Then, when rendering with a one pixel wide pen the QRectF's boundary line will be rendered to the right and below the mathematical rectangle's boundary line.
当按 2 像素宽钢笔渲染时,数学矩形将从中间分割边界线。将是这种情况每当将钢笔设为偶数像素时,当以奇数像素钢笔渲染时,将把备用像素渲染到数学矩形的右侧和下方 (如 1 像素情况)。
![]() |
![]() |
逻辑表示 | 1 像素宽钢笔 |
![]() |
![]() |
2 像素宽钢笔 | 3 像素宽钢笔 |
The QRectF class provides a collection of functions that return the various rectangle coordinates, and enable manipulation of these. QRectF also provides functions to move the rectangle relative to the various coordinates.
例如: bottom (), setBottom () 和 moveBottom () 函数: bottom () 返回矩形下边缘的 Y 坐标, setBottom () 将矩形下边缘设为给定 Y 坐标 (可能改变高度,但从不改变矩形的上边缘) 和 moveBottom () 垂直移动整个矩形,使矩形下边缘留在给定 Y 坐标处且其大小保持不变。
也是可能的,将偏移添加到此矩形的坐标使用 adjust () 函数,及基于原始矩形的调节检索新矩形是使用 adjusted () 函数。若宽度和高度两者任一为负,使用 normalized () 函数以检索角交换矩形。
In addition, QRectF provides the getCoords () 函数提取矩形左上角和右下角的位置,和 getRect () 函数提取矩形的左上角、宽度和高度。使用 setCoords () 和 setRect () 函数能一次性操纵矩形的坐标和尺度。
构造 QRectF 矩形从给定 QRect rectangle .
另请参阅 toRect ().
构造矩形采用 ( x , y ) 作为其左上角和给定 width and height 。所有参数必须是有限的。
另请参阅 setRect ().
构造矩形采用给定 topLeft and bottomRight 角。
另请参阅 setTopLeft () 和 setBottomRight ().
构造矩形采用给定 topLeft 角和给定 size .
另请参阅 setTopLeft () 和 setSize ().
构造 null 矩形。
另请参阅 isNull ().
添加 dx1 , dy1 , dx2 and dy2 respectively to the existing coordinates of the rectangle. All parameters must be finite.
另请参阅 adjusted () 和 setRect ().
返回新的矩形采用 dx1 , dy1 , dx2 and dy2 added respectively to the existing coordinates of this rectangle. All parameters must be finite.
另请参阅 adjust ().
返回矩形底部边缘的 Y 坐标。
另请参阅 setBottom (), bottomLeft (),和 bottomRight ().
返回矩形左下角位置。
另请参阅 setBottomLeft (), bottom (),和 left ().
返回矩形右下角的位置。
另请参阅 setBottomRight (), bottom (),和 right ().
返回矩形的中心点。
另请参阅 moveCenter ().
返回
true
若给定
point
在矩形内或边缘;否则返回
false
.
另请参阅 intersects ().
这是重载函数。
返回
true
若给定
rectangle
在此矩形内;否则返回
false
.
这是重载函数。
返回
true
若点 (
x
,
y
) 在矩形内或边缘;否则返回
false
.
[static, since 5.8]
QRectF
QRectF::
fromCGRect
(
CGRect
rect
)
创建 QRectF 从 CGRect rect .
该函数在 Qt 5.8 引入。
另请参阅 toCGRect ().
将矩形左上角位置提取到 * x1 和 * y1 ,和右下角位置到 * x2 和 * y2 .
另请参阅 setCoords () 和 getRect ().
将矩形左上角位置提取到 * x 和 * y ,和其尺度到 * width 和 * height .
另请参阅 setRect () 和 getCoords ().
返回矩形的高度。
另请参阅 setHeight (), width (),和 size ().
返回交集为此矩形和给定
rectangle
。注意,
r.intersected(s)
相当于
r & s
.
另请参阅 intersects (), united (),和 operator&= ().
返回
true
若此矩形相交给定
rectangle
(即:在它们之间存在非空重叠区域),否则返回
false
.
可以检索交集矩形使用 intersected () 函数。
另请参阅 contains ().
返回
true
若矩形为空,否则返回
false
.
空矩形拥有 width () <= 0 或 height () <= 0。空矩形无效 (即:isEmpty() == ! isValid ()).
使用 normalized () 函数以检索角交换矩形。
另请参阅 isNull (), isValid (),和 normalized ().
返回
true
若矩形是 null 矩形,否则返回
false
.
null 矩形有将宽度和高度两者设为 0。null 矩形也为空,因此无效。
返回
true
若矩形有效,否则返回
false
.
有效矩形拥有 width () > 0 和 height () > 0。注意,非通俗操作 (像交集) 对于无效矩形未定义。有效矩形不为空 (即 isValid() == ! isEmpty ()).
另请参阅 isNull (), isEmpty (),和 normalized ().
返回矩形左边缘的 X 坐标。相当于 x ().
另请参阅 setLeft (), topLeft (),和 bottomLeft ().
[since 5.3]
QRectF
QRectF::
marginsAdded
(const
QMarginsF
&
margins
) const
返回矩形增长按 margins .
该函数在 Qt 5.3 引入。
另请参阅 operator+= (), marginsRemoved (),和 operator-= ().
[since 5.3]
QRectF
QRectF::
marginsRemoved
(const
QMarginsF
&
margins
) const
移除 margins 从矩形,收缩它。
该函数在 Qt 5.3 引入。
另请参阅 marginsAdded (), operator+= (),和 operator-= ().
Moves the rectangle vertically, leaving the rectangle's bottom edge at the given finite y 坐标。矩形的大小保持不变。
另请参阅 bottom (), setBottom (),和 moveTop ().
移动矩形,使左下角留在给定 position 。矩形的大小保持不变。
另请参阅 setBottomLeft (), moveBottom (),和 moveLeft ().
移动矩形,使右下角留在给定 position 。矩形的大小保持不变。
另请参阅 setBottomRight (), moveBottom (),和 moveRight ().
移动矩形,使中心点位于给定 position 。矩形的大小保持不变。
另请参阅 center ().
水平移动矩形,使矩形左边缘留在给定有限 x 坐标。矩形的大小保持不变。
另请参阅 left (), setLeft (),和 moveRight ().
水平移动矩形,使矩形右边缘留在给定有限 x 坐标。矩形的大小保持不变。
另请参阅 right (), setRight (),和 moveLeft ().
移动矩形,使左上角留在给定位置 ( x , y ). The rectangle's size is unchanged. Both parameters must be finite.
另请参阅 translate () 和 moveTopLeft ().
这是重载函数。
移动矩形,使左上角留在给定 position .
垂直移动矩形,使矩形上边线留在给定有限 y 坐标。矩形的大小保持不变。
另请参阅 top (), setTop (),和 moveBottom ().
移动矩形,使左上角留在给定 position 。矩形的大小保持不变。
另请参阅 setTopLeft (), moveTop (),和 moveLeft ().
移动矩形,使右上角留在给定 position 。矩形的大小保持不变。
另请参阅 setTopRight (), moveTop (),和 moveRight ().
返回规范化矩形;即:矩形拥有非负值宽度和高度。
若 width () < 0 函数交换左右角,和它交换上下角若 height () < 0.
返回矩形右边的 X 坐标。
另请参阅 setRight (), topRight (),和 bottomRight ().
Sets the bottom edge of the rectangle to the given finite y 坐标。可能改变高度,但从不会改变矩形的上边缘。
另请参阅 bottom () 和 moveBottom ().
将矩形左下角设为给定 position 。可能改变大小,但从不会改变矩形的右上角。
另请参阅 bottomLeft () 和 moveBottomLeft ().
将矩形右下角设为给定 position 。可能改变大小,但从不改变矩形左上角。
另请参阅 bottomRight () 和 moveBottomRight ().
将矩形左上角坐标设为 ( x1 , y1 ),和它的右下角坐标到 ( x2 , y2 )。所有参数必须是有限的。
另请参阅 getCoords () 和 setRect ().
Sets the height of the rectangle to the given finite height 。下边缘改变,但不改变上边缘。
Sets the left edge of the rectangle to the given finite x 坐标。可能改变宽度,但从不会改变矩形的右边缘。
相当于 setX ().
将矩形左上角坐标设为 ( x , y ),和它的大小到给定 width and height 。所有参数必须是有限的。
另请参阅 getRect () 和 setCoords ().
Sets the right edge of the rectangle to the given finite x 坐标。可能改变宽度,但从不会改变矩形的左边缘。
Sets the size of the rectangle to the given finite size 。不移动左上角。
另请参阅 size (), setWidth (),和 setHeight ().
Sets the top edge of the rectangle to the given finite y 坐标。可能改变高度,但从不会改变矩形的下边缘。
相当于 setY ().
将矩形左上角设为给定 position 。可能改变大小,但从不改变矩形的右下角。
另请参阅 topLeft () 和 moveTopLeft ().
将矩形右上角设为给定 position 。可能改变大小,但从不改变矩形的右下角。
另请参阅 topRight () 和 moveTopRight ().
Sets the width of the rectangle to the given finite width 。右边缘改变,但左边缘不改变。
Sets the left edge of the rectangle to the given finite x 坐标。可能改变宽度,但从不会改变矩形的右边缘。
相当于 setLeft ().
另请参阅 x (), setY (),和 setTopLeft ().
Sets the top edge of the rectangle to the given finite y 坐标。可能改变高度,但从不会改变矩形的下边缘。
相当于 setTop ().
另请参阅 y (), setX (),和 setTopLeft ().
返回矩形的大小。
另请参阅 setSize (), width (),和 height ().
返回 QRect 基于此矩形 (完全包含此矩形的最小可能整数矩形) 的值。
另请参阅 toRect ().
[since 5.8]
CGRect
QRectF::
toCGRect
() const
创建 CGRect 从 QRectF .
该函数在 Qt 5.8 引入。
另请参阅 fromCGRect ().
返回 QRect 基于此矩形的值。注意,返回矩形的坐标会被四舍五入到最近整数。
另请参阅 QRectF () 和 toAlignedRect ().
返回矩形上边缘的 Y 坐标。相当于 y ().
另请参阅 setTop (), topLeft (),和 topRight ().
返回矩形左上角的位置。
另请参阅 setTopLeft (), top (),和 left ().
返回矩形右上角的位置。
另请参阅 setTopRight (), top (),和 right ().
移动矩形 dx 沿 X 轴和 dy along the y-axis, relative to the current position. Positive values move the rectangle to the right and downwards. Both parameters must be finite.
另请参阅 moveTopLeft (), moveTo (),和 translated ().
这是重载函数。
移动矩形 offset . x() 沿 X 轴和 offset . y() 沿 Y 轴,相对当前位置。
返回的矩形副本有翻译 dx 沿 X 轴和 dy along the y axis, relative to the current position. Positive values move the rectangle to the right and down. Both parameters must be finite.
另请参阅 translate ().
这是重载函数。
返回的矩形副本有翻译 offset . x() 沿 X 轴和 offset . y() 沿 Y 轴,相对当前位置。
[since 5.7]
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}
该函数在 Qt 5.7 引入。
另请参阅 QSizeF::transposed ().
返回边界矩形为此矩形和给定 rectangle .
另请参阅 intersected ().
返回矩形的宽度。
另请参阅 setWidth (), height (),和 size ().
返回矩形左边缘的 X 坐标。相当于 left ().
另请参阅 setX (), y (),和 topLeft ().
返回矩形上边缘的 Y 坐标。相当于 top ().
另请参阅 setY (), x (),和 topLeft ().
返回交集为此矩形和给定 rectangle 。返回空矩形若没有交集。
另请参阅 operator&= () 和 intersected ().
相交此矩形与给定 rectangle .
另请参阅 intersected () 和 operator& ().
[since 5.3]
QRectF
&QRectF::
operator+=
(const
QMarginsF
&
margins
)
添加 margins 到矩形,增长它。
该函数在 Qt 5.3 引入。
另请参阅 marginsAdded (), marginsRemoved (),和 operator-= ().
[since 5.3]
QRectF
&QRectF::
operator-=
(const
QMarginsF
&
margins
)
返回矩形的收缩按 margins .
该函数在 Qt 5.3 引入。
另请参阅 marginsRemoved (), operator+= (),和 marginsAdded ().
返回边界矩形为此矩形和给定 rectangle .
另请参阅 united () 和 operator|= ().
联合此矩形与给定 rectangle .
另请参阅 united () 和 operator| ().
返回
true
若矩形
r1
and
r2
are sufficiently different, otherwise returns
false
.
警告: This function does not check for strict inequality; instead, it uses a fuzzy comparison to compare the rectangles' coordinates.
[since 5.3]
QRectF
operator+
(const
QRectF
&
lhs
, const
QMarginsF
&
rhs
)
返回 lhs 矩形增长按 rhs 边距。
该函数在 Qt 5.3 引入。
[since 5.3]
QRectF
operator+
(const
QMarginsF
&
lhs
, const
QRectF
&
rhs
)
这是重载函数。
返回 lhs 矩形增长按 rhs 边距。
该函数在 Qt 5.3 引入。
[since 5.3]
QRectF
operator-
(const
QRectF
&
lhs
, const
QMarginsF
&
rhs
)
返回 lhs rectangle shrunk by the rhs 边距。
该函数在 Qt 5.3 引入。
写入 rectangle 到 stream ,并返回流引用。
另请参阅 序列化 Qt 数据类型 .
返回
true
若矩形
r1
and
r2
are
approximately
等于,否则返回
false
.
警告: This function does not check for strict equality; instead, it uses a fuzzy comparison to compare the rectangles' coordinates.
另请参阅 qFuzzyCompare .
读取 rectangle 从 stream ,并返回流引用。
另请参阅 序列化 Qt 数据类型 .