QRectF class defines a rectangle in the plane using floating point precision. 更多...
| 头： | #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 ) |
QRectF class defines a rectangle in the plane using floating point precision.
A rectangle is normally expressed as an upper-left corner and a size. The size (width and height) of a QRectF is always equivalent to the mathematical rectangle that forms the basis for its rendering.
A QRectF can be constructed with a set of left, top, width and height coordinates, or from a 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));
There is also a third constructor creating a QRectF from a QRect ，且相应 toRect () 函数返回 QRect 对象基于此矩形值 (注意：返回矩形的坐标会被四舍五入到最近整数)。
QRectF class provides a collection of functions that return the various rectangle coordinates, and enable manipulation of these. QRectF also provide functions to move the rectangle relative to the various coordinates. In addition there is a moveTo () 函数移动矩形，将它的左上角留在给定坐标处。另外， translate () 函数相对当前位置将矩形移动给定偏移，和 translated () 函数返回此矩形的翻译副本。
size () function returns the rectange's dimensions as a 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
() function which returns the intersection rectangle, and the
united
() function which returns the rectangle that encloses the given rectangle and this:
|
|
| intersected () | united () |
isEmpty
() 函数返回
true
if the rectangle's width or height is less than, or equal to, 0. Note that an empty rectangle is not valid: The
isValid
() 函数返回
true
if both width and height is larger than 0. A null rectangle (
isNull
() == true) on the other hand, has both width and height set to 0.
Note that due to the way QRect and QRectF are defined, an empty QRectF is defined in essentially the same way as QRect .
最后， QRectF 对象可以被流化及比较。
当使用 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.
When rendering with a two pixels wide pen the boundary line will be split in the middle by the mathematical rectangle. This will be the case whenever the pen is set to an even number of pixels, while rendering with a pen with an odd number of pixels, the spare pixel will be rendered to the right and below the mathematical rectangle as in the one pixel case.
|
|
| 逻辑表示 | 1 像素宽钢笔 |
|
|
| 2 像素宽钢笔 | 3 像素宽钢笔 |
QRectF class provides a collection of functions that return the various rectangle coordinates, and enable manipulation of these. QRectF also provide functions to move the rectangle relative to the various coordinates.
例如： bottom (), setBottom () 和 moveBottom () 函数： bottom () 返回矩形下边缘的 Y 坐标， setBottom () sets the bottom edge of the rectangle to the given y coordinate (it may change the height, but will never change the rectangle's top edge) and moveBottom () moves the entire rectangle vertically, leaving the rectangle's bottom edge at the given y coordinate and its size unchanged.
It is also possible to add offsets to this rectangle's coordinates using the adjust () function, as well as retrieve a new rectangle based on adjustments of the original one using the adjusted () function. If either of the width and height is negative, use the normalized () 函数能检索角被交换的矩形。
此外， QRectF 提供 getCoords () function which extracts the position of the rectangle's top-left and bottom-right corner, and the getRect () function which extracts the rectangle's top-left corner, width and height. Use the setCoords () 和 setRect () function to manipulate the rectangle's coordinates and dimensions in one go.
构造 null 矩形。
另请参阅 isNull ().
构造矩形采用给定 topLeft 角和给定 size .
另请参阅 setTopLeft () 和 setSize ().
构造矩形采用给定 topLeft and bottomRight 角。
该函数在 Qt 4.3 引入。
另请参阅 setTopLeft () 和 setBottomRight ().
构造矩形采用 ( x , y ) 作为其左上角和给定 width and height .
另请参阅 setRect ().
构造 QRectF rectangle from the given QRect rectangle .
另请参阅 toRect ().
添加 dx1 , dy1 , dx2 and dy2 respectively to the existing coordinates of the rectangle.
另请参阅 adjusted () 和 setRect ().
返回新的矩形采用 dx1 , dy1 , dx2 and dy2 added respectively to the existing coordinates of this rectangle.
另请参阅 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 ().
Extracts the position of the rectangle's top-left corner to * x1 和 * y1 , and the position of the bottom-right corner to * x2 和 * y2 .
另请参阅 setCoords () 和 getRect ().
Extracts the position of the rectangle's top-left corner to * x 和 * y , and its dimensions to * 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
.
A null rectangle has both the width and the height set to 0. A null rectangle is also empty, and hence not valid.
返回
true
若矩形有效，否则返回
false
.
有效矩形拥有 width () > 0 和 height () > 0. Note that non-trivial operations like intersections are not defined for invalid rectangles. A valid rectangle is not empty (i.e., isValid() == ! isEmpty ()).
另请参阅 isNull (), isEmpty ()，和 normalized ().
返回矩形左边缘的 X 坐标。相当于 x ().
另请参阅 setLeft (), topLeft ()，和 bottomLeft ().
返回矩形增长按 margins .
该函数在 Qt 5.3 引入。
另请参阅 operator+= (), marginsRemoved ()，和 operator-= ().
移除 margins 从矩形，收缩它。
该函数在 Qt 5.3 引入。
另请参阅 marginsAdded (), operator+= ()，和 operator-= ().
Moves the rectangle vertically, leaving the rectangle's bottom edge at the given y 坐标。矩形大小不变。
另请参阅 bottom (), setBottom ()，和 moveTop ().
Moves the rectangle, leaving the bottom-left corner at the given position 。矩形大小不变。
另请参阅 setBottomLeft (), moveBottom ()，和 moveLeft ().
移动矩形，使右下角留在给定 position 。矩形大小不变。
另请参阅 setBottomRight (), moveBottom ()，和 moveRight ().
移动矩形，使中心点位于给定 position 。矩形大小不变。
另请参阅 center ().
Moves the rectangle horizontally, leaving the rectangle's left edge at the given x 坐标。矩形大小不变。
另请参阅 left (), setLeft ()，和 moveRight ().
Moves the rectangle horizontally, leaving the rectangle's right edge at the given x 坐标。矩形大小不变。
另请参阅 right (), setRight ()，和 moveLeft ().
Moves the rectangle, leaving the top-left corner at the given position ( x , y ). The rectangle's size is unchanged.
另请参阅 translate () 和 moveTopLeft ().
这是重载函数。
移动矩形，将左上角留在给定 position .
Moves the rectangle vertically, leaving the rectangle's top line at the given 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 y 坐标。可能改变高度，但从不会改变矩形的上边缘。
另请参阅 bottom () 和 moveBottom ().
将矩形左下角设为给定 position 。可能改变大小，但从不会改变矩形的右上角。
另请参阅 bottomLeft () 和 moveBottomLeft ().
将矩形右下角设为给定 position 。可能改变大小，但从不会改变矩形的左上角。
另请参阅 bottomRight () 和 moveBottomRight ().
将矩形左上角坐标设为 ( x1 , y1 )，和它的右下角坐标到 ( x2 , y2 ).
另请参阅 getCoords () 和 setRect ().
Sets the height of the rectangle to the given height 。底边缘被改变，但不改变顶边缘。
Sets the left edge of the rectangle to the given x 坐标。可能改变宽度，但从不会改变矩形的右边缘。
相当于 setX ().
将矩形左上角坐标设为 ( x , y )，和它的大小到给定 width and height .
另请参阅 getRect () 和 setCoords ().
Sets the right edge of the rectangle to the given x 坐标。可能改变宽度，但从不会改变矩形的左边缘。
Sets the size of the rectangle to the given size 。不移动左上角。
另请参阅 size (), setWidth ()，和 setHeight ().
Sets the top edge of the rectangle to the given y 坐标。可能改变高度，但从不会改变矩形的底边缘。
相当于 setY ().
Set the top-left corner of the rectangle to the given position . May change the size, but will never change the bottom-right corner of the rectangle.
另请参阅 topLeft () 和 moveTopLeft ().
Set the top-right corner of the rectangle to the given position . May change the size, but will never change the bottom-left corner of the rectangle.
另请参阅 topRight () 和 moveTopRight ().
Sets the width of the rectangle to the given width . The right edge is changed, but not the left one.
Sets the left edge of the rectangle to the given x 坐标。可能改变宽度，但从不会改变矩形的右边缘。
相当于 setLeft ().
另请参阅 x (), setY ()，和 setTopLeft ().
Sets the top edge of the rectangle to the given y 坐标。可能改变高度，但从不会改变矩形的底边缘。
相当于 setTop ().
另请参阅 y (), setX ()，和 setTopLeft ().
返回矩形的大小。
另请参阅 setSize (), width ()，和 height ().
返回 QRect based on the values of this rectangle that is the smallest possible integer rectangle that completely contains this rectangle.
该函数在 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 along the y-axis, relative to the current position. Positive values move the rectangle to the right and downwards.
另请参阅 moveTopLeft (), moveTo ()，和 translated ().
这是重载函数。
移动矩形 offset . x() 沿 X 轴和 offset . y() along the y axis, relative to the current position.
Returns a copy of the rectangle that is translated dx 沿 X 轴和 dy along the y axis, relative to the current position. Positive values move the rectangle to the right and down.
另请参阅 translate ().
这是重载函数。
Returns a copy of the rectangle that is translated offset . x() 沿 X 轴和 offset . y() along the y axis, relative to the current position.
返回交换了宽度和高度的矩形副本：
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
不同，否则返回
false
.
返回 lhs 矩形增长按 rhs 边距。
该函数在 Qt 5.3 引入。
这是重载函数。
返回 lhs 矩形增长按 rhs 边距。
该函数在 Qt 5.3 引入。
返回 lhs 矩形增长按 rhs 边距。
该函数在 Qt 5.3 引入。
写入 rectangle 到 stream ，并返回流引用。
另请参阅 序列化 Qt 数据类型 .
返回
true
若矩形
r1
and
r2
相等，否则返回
false
.
读取 rectangle 从 stream ，并返回流引用。
另请参阅 序列化 Qt 数据类型 .