The QRectF 类使用浮点精度定义平面矩形。 更多...
| 头： | #include <QRectF> |
| qmake: | QT += core |
注意： 此类的所有函数 可重入 .
| QRectF () | |
| QRectF (const QPointF & topLeft , const QSizeF & size ) | |
| QRectF (const QPointF & topLeft , const QPointF & bottomRight ) | |
| QRectF (qreal x , qreal y , qreal width , qreal height ) | |
| QRectF (const QRect & rectangle ) | |
| 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 ) |
The QRectF 类使用浮点精度定义平面矩形。
A rectangle is normally expressed as a top-left corner and a size. The size (width and height) of a QRectF 始终相当于形成其渲染基础的数学矩形。
A 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 类提供了返回各种矩形坐标，并使之能够操纵这些坐标的一批函数。 QRectF also provides functions to move the rectangle relative to the various coordinates. In addition there is a moveTo () 函数能移动矩形，使其左上角留在给定坐标处。另外， translate () 函数相对当前位置将矩形移动给定偏移，和 translated () 函数返回此矩形的翻译副本。
The size () 函数返回矩形的尺度按 QSizeF 。还可以单独检索尺度使用 width () 和 height () 函数。要操纵维度使用 setSize (), setWidth () 或 setHeight () 函数。另外，通过应用设置矩形坐标的函数可以改变大小，例如 setBottom () 或 setRight ().
The
contains
() 函数告诉给定点是否在矩形内，和
intersects
() 函数返回
true
若此矩形与给定矩形相交 (否则 false)。
QRectF
类还提供
intersected
() 函数返回交集矩形，和
united
() 函数返回包围给定矩形的矩形，如下所示：
|
|
| intersected () | united () |
The
isEmpty
() 函数返回
true
若矩形的宽度或高度小于或等于 0。注意，空矩形无效：
isValid
() 函数返回
true
若宽度和高度两者 > 0。null 矩形 (
isNull
() == true) 另一方面，有将宽度和高度两者设为 0。
注意，由于方式有关 QRect and QRectF 的定义，空 QRectF 的定义方式本质上如同 QRect .
最后， QRectF 对象可以被流化及比较。
当使用 抗锯齿 描绘器，边界线对于 QRectF 将对称渲染在数学矩形边界线的 2 侧。但当使用锯齿描绘器 (默认) 时，应用其它规则。
那么，当按 1 像素宽钢笔渲染时 QRectF 的边界线将渲染在数学矩形边界线的右侧和下方。
当按 2 像素宽钢笔渲染时，数学矩形将从中间分割边界线。将是这种情况每当将钢笔设为偶数像素时，当以奇数像素钢笔渲染时，将把备用像素渲染到数学矩形的右侧和下方 (如 1 像素情况)。
|
|
| 逻辑表示 | 1 像素宽钢笔 |
|
|
| 2 像素宽钢笔 | 3 像素宽钢笔 |
The QRectF 类提供了返回各种矩形坐标，并使之能够操纵这些坐标的一批函数。 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 () 函数以检索角交换矩形。
此外， QRectF 提供 getCoords () 函数提取矩形左上角和右下角的位置，和 getRect () 函数提取矩形的左上角、宽度和高度。使用 setCoords () 和 setRect () 函数能一次性操纵矩形的坐标和尺度。
构造 null 矩形。
另请参阅 isNull ().
构造矩形采用给定 topLeft 角和给定 size .
另请参阅 setTopLeft () 和 setSize ().
构造矩形采用给定 topLeft and bottomRight 角。
该函数在 Qt 4.3 引入。
另请参阅 setTopLeft () 和 setBottomRight ().
构造矩形采用 ( x , y ) 作为其左上角和给定 width and height .
另请参阅 setRect ().
构造 QRectF 矩形从给定 QRect rectangle .
另请参阅 toRect ().
添加 dx1 , dy1 , dx2 and dy2 分别到矩形的现有坐标。
另请参阅 adjusted () 和 setRect ().
返回新的矩形采用 dx1 , dy1 , dx2 and dy2 分别添加到此矩形的现有坐标。
另请参阅 adjust ().
返回矩形底部边缘的 Y 坐标。
另请参阅 setBottom (), bottomLeft ()，和 bottomRight ().
返回矩形左下角位置。
另请参阅 setBottomLeft (), bottom ()，和 left ().
返回矩形右下角的位置。
另请参阅 setBottomRight (), bottom ()，和 right ().
返回矩形的中心点。
另请参阅 moveCenter ().
返回
true
若给定
point
在矩形内或边缘；否则返回
false
.
另请参阅 intersects ().
这是重载函数。
返回
true
若给定
rectangle
在此矩形内；否则返回
false
.
这是重载函数。
返回
true
若点 (
x
,
y
) 在矩形内或边缘；否则返回
false
.
[static]
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
.
该函数在 Qt 4.2 引入。
另请参阅 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 ().
返回矩形增长按 margins .
该函数在 Qt 5.3 引入。
另请参阅 operator+= (), marginsRemoved ()，和 operator-= ().
移除 margins 从矩形，收缩它。
该函数在 Qt 5.3 引入。
另请参阅 marginsAdded (), operator+= ()，和 operator-= ().
垂直移动矩形，使矩形底边线留在给定 y 坐标。矩形的大小保持不变。
另请参阅 bottom (), setBottom ()，和 moveTop ().
移动矩形，使左下角留在给定 position 。矩形的大小保持不变。
另请参阅 setBottomLeft (), moveBottom ()，和 moveLeft ().
移动矩形，使右下角留在给定 position 。矩形的大小保持不变。
另请参阅 setBottomRight (), moveBottom ()，和 moveRight ().
移动矩形，使中心点位于给定 position 。矩形的大小保持不变。
另请参阅 center ().
水平移动矩形，使矩形左边缘留在给定 x 坐标。矩形的大小保持不变。
另请参阅 left (), setLeft ()，和 moveRight ().
水平移动矩形，使矩形右边缘留在给定 x 坐标。矩形的大小保持不变。
另请参阅 right (), setRight ()，和 moveLeft ().
移动矩形，使左上角留在给定位置 ( x , y )。矩形的大小保持不变。
另请参阅 translate () 和 moveTopLeft ().
这是重载函数。
移动矩形，使左上角留在给定 position .
垂直移动矩形，使矩形上边线留在给定 y 坐标。矩形的大小保持不变。
另请参阅 top (), setTop ()，和 moveBottom ().
移动矩形，使左上角留在给定 position 。矩形的大小保持不变。
另请参阅 setTopLeft (), moveTop ()，和 moveLeft ().
移动矩形，使右上角留在给定 position 。矩形的大小保持不变。
另请参阅 setTopRight (), moveTop ()，和 moveRight ().
返回规范化矩形；即：矩形拥有非负值宽度和高度。
若 width () < 0 函数交换左右角，和它交换上下角若 height () < 0.
返回矩形右边的 X 坐标。
另请参阅 setRight (), topRight ()，和 bottomRight ().
将矩形下边缘设为给定 y 坐标。可能改变高度，但从不会改变矩形的上边缘。
另请参阅 bottom () 和 moveBottom ().
将矩形左下角设为给定 position 。可能改变大小，但从不会改变矩形的右上角。
另请参阅 bottomLeft () 和 moveBottomLeft ().
将矩形右下角设为给定 position 。可能改变大小，但从不改变矩形左上角。
另请参阅 bottomRight () 和 moveBottomRight ().
将矩形左上角坐标设为 ( x1 , y1 )，和它的右下角坐标到 ( x2 , y2 ).
另请参阅 getCoords () 和 setRect ().
将矩形高度设为给定 height 。下边缘改变，但不改变上边缘。
将矩形左边缘设为给定 x 坐标。可能改变宽度，但从不会改变矩形的右边缘。
相当于 setX ().
将矩形左上角坐标设为 ( x , y )，和它的大小到给定 width and height .
另请参阅 getRect () 和 setCoords ().
将矩形右边缘设为给定 x 坐标。可能改变宽度，但从不会改变矩形的左边缘。
将矩形大小设为给定 size 。不移动左上角。
另请参阅 size (), setWidth ()，和 setHeight ().
将矩形上边缘设为给定 y 坐标。可能改变高度，但从不会改变矩形的下边缘。
相当于 setY ().
将矩形左上角设为给定 position 。可能改变大小，但从不改变矩形的右下角。
另请参阅 topLeft () 和 moveTopLeft ().
将矩形右上角设为给定 position 。可能改变大小，但从不改变矩形的右下角。
另请参阅 topRight () 和 moveTopRight ().
将矩形宽度设为给定 width 。右边缘改变，但左边缘不改变。
将矩形左边缘设为给定 x 坐标。可能改变宽度，但从不会改变矩形的右边缘。
相当于 setLeft ().
另请参阅 x (), setY ()，和 setTopLeft ().
将矩形上边缘设为给定 y 坐标。可能改变高度，但从不会改变矩形的下边缘。
相当于 setTop ().
另请参阅 y (), setX ()，和 setTopLeft ().
返回矩形的大小。
另请参阅 setSize (), width ()，和 height ().
返回 QRect 基于此矩形 (完全包含此矩形的最小可能整数矩形) 的值。
该函数在 Qt 4.3 引入。
另请参阅 toRect ().
创建 CGRect 从 QRectF .
该函数在 Qt 5.8 引入。
另请参阅 fromCGRect ().
返回 QRect 基于此矩形的值。注意，返回矩形的坐标会被四舍五入到最近整数。
另请参阅 QRectF () 和 toAlignedRect ().
返回矩形上边缘的 Y 坐标。相当于 y ().
另请参阅 setTop (), topLeft ()，和 topRight ().
返回矩形左上角的位置。
另请参阅 setTopLeft (), top ()，和 left ().
返回矩形右上角的位置。
另请参阅 setTopRight (), top ()，和 right ().
移动矩形 dx 沿 X 轴和 dy 沿 Y 轴，相对当前位置。正值将矩形向右和向下移动。
另请参阅 moveTopLeft (), moveTo ()，和 translated ().
这是重载函数。
移动矩形 offset . x() 沿 X 轴和 offset . y() 沿 Y 轴，相对当前位置。
返回的矩形副本有翻译 dx 沿 X 轴和 dy 沿 Y 轴，相对当前位置。正值向右下移动矩形。
另请参阅 translate ().
这是重载函数。
返回的矩形副本有翻译 offset . x() 沿 X 轴和 offset . y() 沿 Y 轴，相对当前位置。
返回交换了宽度和高度的矩形副本：
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 .
该函数在 Qt 4.2 引入。
另请参阅 intersected ().
返回矩形的宽度。
另请参阅 setWidth (), height ()，和 size ().
返回矩形左边缘的 X 坐标。相当于 left ().
另请参阅 setX (), y ()，和 topLeft ().
返回矩形上边缘的 Y 坐标。相当于 top ().
另请参阅 setY (), x ()，和 topLeft ().
返回交集为此矩形和给定 rectangle 。返回空矩形若没有交集。
另请参阅 operator&= () 和 intersected ().
相交此矩形与给定 rectangle .
另请参阅 intersected () 和 operator|= ().
添加 margins 到矩形，增长它。
该函数在 Qt 5.3 引入。
另请参阅 marginsAdded (), marginsRemoved ()，和 operator-= ().
返回矩形的收缩按 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.
返回 lhs 矩形增长按 rhs 边距。
该函数在 Qt 5.3 引入。
这是重载函数。
返回 lhs 矩形增长按 rhs 边距。
该函数在 Qt 5.3 引入。
返回 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 数据类型 .