The QRect 类使用整数精度定义平面矩形。 更多...
| 头： | #include <QRect> |
| qmake: | QT += core |
注意： 此类的所有函数 可重入 .
| QRect () | |
| QRect (const QPoint & topLeft , const QPoint & bottomRight ) | |
| QRect (const QPoint & topLeft , const QSize & size ) | |
| QRect (int x , int y , int width , int height ) | |
| void | adjust (int dx1 , int dy1 , int dx2 , int dy2 ) |
| QRect | adjusted (int dx1 , int dy1 , int dx2 , int dy2 ) const |
| int | bottom () const |
| QPoint | bottomLeft () const |
| QPoint | bottomRight () const |
| QPoint | center () const |
| bool | contains (const QPoint & point , bool proper = false) const |
| bool | contains (const QRect & rectangle , bool proper = false) const |
| bool | contains (int x , int y ) const |
| bool | contains (int x , int y , bool proper ) const |
| void | getCoords (int * x1 , int * y1 , int * x2 , int * y2 ) const |
| void | getRect (int * x , int * y , int * width , int * height ) const |
| int | height () const |
| QRect | intersected (const QRect & rectangle ) const |
| bool | intersects (const QRect & rectangle ) const |
| bool | isEmpty () const |
| bool | isNull () const |
| bool | isValid () const |
| int | left () const |
| QRect | marginsAdded (const QMargins & margins ) const |
| QRect | marginsRemoved (const QMargins & margins ) const |
| void | moveBottom (int y ) |
| void | moveBottomLeft (const QPoint & position ) |
| void | moveBottomRight (const QPoint & position ) |
| void | moveCenter (const QPoint & position ) |
| void | moveLeft (int x ) |
| void | moveRight (int x ) |
| void | moveTo (int x , int y ) |
| void | moveTo (const QPoint & position ) |
| void | moveTop (int y ) |
| void | moveTopLeft (const QPoint & position ) |
| void | moveTopRight (const QPoint & position ) |
| QRect | normalized () const |
| int | right () const |
| void | setBottom (int y ) |
| void | setBottomLeft (const QPoint & position ) |
| void | setBottomRight (const QPoint & position ) |
| void | setCoords (int x1 , int y1 , int x2 , int y2 ) |
| void | setHeight (int height ) |
| void | setLeft (int x ) |
| void | setRect (int x , int y , int width , int height ) |
| void | setRight (int x ) |
| void | setSize (const QSize & size ) |
| void | setTop (int y ) |
| void | setTopLeft (const QPoint & position ) |
| void | setTopRight (const QPoint & position ) |
| void | setWidth (int width ) |
| void | setX (int x ) |
| void | setY (int y ) |
| QSize | size () const |
| CGRect | toCGRect () const |
| int | top () const |
| QPoint | topLeft () const |
| QPoint | topRight () const |
| void | translate (int dx , int dy ) |
| void | translate (const QPoint & offset ) |
| QRect | translated (int dx , int dy ) const |
| QRect | translated (const QPoint & offset ) const |
| QRect | transposed () const |
| QRect | united (const QRect & rectangle ) const |
| int | width () const |
| int | x () const |
| int | y () const |
| QRect | operator& (const QRect & rectangle ) const |
| QRect & | operator&= (const QRect & rectangle ) |
| QRect & | operator+= (const QMargins & margins ) |
| QRect & | operator-= (const QMargins & margins ) |
| QRect | operator| (const QRect & rectangle ) const |
| QRect & | operator|= (const QRect & rectangle ) |
| bool | operator!= (const QRect & r1 , const QRect & r2 ) |
| QRect | operator+ (const QRect & rectangle , const QMargins & margins ) |
| QRect | operator+ (const QMargins & margins , const QRect & rectangle ) |
| QRect | operator- (const QRect & lhs , const QMargins & rhs ) |
| QDataStream & | operator<< (QDataStream & stream , const QRect & rectangle ) |
| bool | operator== (const QRect & r1 , const QRect & r2 ) |
| QDataStream & | operator>> (QDataStream & stream , QRect & rectangle ) |
The QRect 类使用整数精度定义平面矩形。
A rectangle is normally expressed as a top-left corner and a size. The size (width and height) of a QRect 始终相当于形成其渲染基础的数学矩形。
A QRect 可以按左、上、宽度及高度的一组整数构造 QRect，或从 QPoint 和 QSize 。以下代码创建 2 个恒等矩形。
QRect r1(100, 200, 11, 16); QRect r2(QPoint(100, 200), QSize(11, 16));
有第 3 个构造函数创建 QRect 使用左上和右下坐标，但推荐避免使用它。基本原理是出于历史原因，值返回通过 bottom () 和 right () 函数会偏离矩形的真正右下角。
The QRect 类提供了返回各种矩形坐标，并使之能够操纵这些坐标的一批函数。 QRect also provides functions to move the rectangle relative to the various coordinates. In addition there is a moveTo () 函数能移动矩形，使其左上角留在给定坐标处。另外， translate () 函数相对当前位置将矩形移动给定偏移，和 translated () 函数返回此矩形的翻译副本。
The size () 函数返回矩形的尺度按 QSize 。还可以单独检索尺度使用 width () 和 height () 函数。要操纵维度使用 setSize (), setWidth () 或 setHeight () 函数。另外，通过应用设置矩形坐标的函数可以改变大小，例如 setBottom () 或 setRight ().
The
contains
() 函数告诉给定点是否在矩形内，和
intersects
() 函数返回
true
若此矩形与给定矩形相交。
QRect
类还提供
intersected
() 函数返回交集矩形，和
united
() 函数返回包围给定矩形的矩形，如下所示：
|
|
| intersected () | united () |
The
isEmpty
() 函数返回
true
if
left
() >
right
() 或
top
() >
bottom
()。注意，空矩形无效：
isValid
() 函数返回
true
if
left
() <=
right
()
and
top
() <=
bottom
()。null 矩形 (
isNull
() == true) 另一方面，有将宽度和高度两者设为 0。
注意，由于方式有关 QRect and QRectF 的定义，空 QRect 的定义方式本质上如同 QRectF .
最后， QRect 对象可以被流化及比较。
当使用 抗锯齿 描绘器，边界线对于 QRect 将对称渲染在数学矩形边界线的 2 侧。但当使用锯齿描绘器 (默认) 时，应用其它规则。
那么，当按 1 像素宽钢笔渲染时 QRect 的边界线将渲染在数学矩形边界线的右侧和下方。
当按 2 像素宽钢笔渲染时，数学矩形将从中间分割边界线。将是这种情况每当将钢笔设为偶数像素时，当以奇数像素钢笔渲染时，将把备用像素渲染到数学矩形的右侧和下方 (如 1 像素情况)。
|
|
| 逻辑表示 | 1 像素宽钢笔 |
|
|
| 2 像素宽钢笔 | 3 像素宽钢笔 |
The QRect 类提供了返回各种矩形坐标，并使之能够操纵这些坐标的一批函数。 QRect also provides functions to move the rectangle relative to the various coordinates.
例如 left (), setLeft () 和 moveLeft () 函数范例： left () 返回矩形左边缘的 X 坐标， setLeft () 将矩形左边缘设为给定 X 坐标 (可能改变宽度，但从不改变矩形的右边缘) 和 moveLeft () 水平移动整个矩形，使矩形左边缘留在给定 X 坐标处且其大小保持不变。
注意，由于历史原因，值返回通过 bottom () 和 right () 函数会偏离矩形的真正右下角： right () 函数返回 left () + width () - 1 和 bottom () 函数返回 top () + height () - 1 。相同情况是点返回通过 bottomRight () 方便函数。此外，X 和 Y 坐标对于 topRight () 和 bottomLeft () 函数，分别包含来自真正右边缘和底边缘的相同偏离。
推荐使用 x () + width () 和 y () + height () 查找真正右下角，并避免 right () 和 bottom ()。另一解决方案是使用 QRectF ： QRectF 类使用浮点精度坐标定义平面矩形，和 QRectF::right () 和 QRectF::bottom () 函数 do 返回右坐标和下坐标。
也是可能的，将偏移添加到此矩形的坐标使用 adjust () 函数，及基于原始矩形的调节检索新矩形是使用 adjusted () 函数。若宽度和高度两者任一为负，使用 normalized () 函数以检索角交换矩形。
此外， QRect 提供 getCoords () 函数提取矩形左上角和右下角的位置，和 getRect () 函数提取矩形的左上角、宽度和高度。使用 setCoords () 和 setRect () 函数能一次性操纵矩形的坐标和尺度。
QRect
被限制到最小和最大值是由于
int
类型。操作
QRect
潜在可能导致值超出此范围，会产生未定义行为。
构造 null 矩形。
另请参阅 isNull ().
构造矩形采用给定 topLeft and bottomRight 角。
另请参阅 setTopLeft () 和 setBottomRight ().
构造矩形采用给定 topLeft 角和给定 size .
另请参阅 setTopLeft () 和 setSize ().
构造矩形采用 ( x , y ) 作为其左上角和给定 width and height .
另请参阅 setRect ().
添加 dx1 , dy1 , dx2 and dy2 分别到矩形的现有坐标。
另请参阅 adjusted () 和 setRect ().
返回新的矩形采用 dx1 , dy1 , dx2 and dy2 分别添加到此矩形的现有坐标。
另请参阅 adjust ().
返回矩形底部边缘的 Y 坐标。
注意：由于历史原因，此函数返回 top () + height () - 1；使用 y () + height () 来检索为 true 的 Y 坐标。
另请参阅 setBottom (), bottomLeft ()，和 bottomRight ().
返回矩形的左下角位置。注意，由于历史原因，此函数返回 QPoint ( left (), top () + height () - 1).
另请参阅 setBottomLeft (), bottom ()，和 left ().
返回矩形右下角的位置。
注意：由于历史原因，此函数返回 QPoint ( left () + width () -1, top () + height () - 1).
另请参阅 setBottomRight (), bottom ()，和 right ().
返回矩形的中心点。
另请参阅 moveCenter ().
返回
true
若给定
point
在矩形内 (或在矩形边缘上)，否则返回
false
。若
proper
为 True，此函数才返回
true
若给定
point
is
inside
矩形 (即：不在边缘)。
另请参阅 intersects ().
这是重载函数。
返回
true
若给定
rectangle
在此矩形内。否则返回
false
。若
proper
为 True，此函数才返回
true
若
rectangle
完全在此矩形内 (不在边缘上)。
这是重载函数。
返回
true
若点 (
x
,
y
) 在此矩形内，否则返回
false
.
这是重载函数。
返回
true
若点 (
x
,
y
) 在矩形内 (或在矩形边缘上)，否则返回
false
。若
proper
为 True，此函数才返回
true
若点完全在矩形内 (不在边缘上)。
将矩形左上角位置提取到 * 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
(即：至少有一像素在 2 矩形内)，否则返回
false
.
可以检索交集矩形使用 intersected () 函数。
另请参阅 contains ().
返回
true
若矩形为空，否则返回
false
.
空矩形拥有 left () > right () 或 top () > bottom ()。空矩形无效 (即 isEmpty() == ! isValid ()).
使用 normalized () 函数以检索角交换矩形。
另请参阅 isNull (), isValid ()，和 normalized ().
返回
true
若矩形是 null 矩形，否则返回
false
.
null 矩形有将宽度和高度两者设为 0 (即 right () == left () - 1 and bottom () == top () - 1)。null 矩形也为空，因此无效。
返回
true
若矩形有效，否则返回
false
.
有效矩形拥有 left () <= right () 和 top () <= bottom ()。注意，非通俗操作 (像交集) 对于无效矩形未定义。有效矩形不为空 (即 isValid() == ! isEmpty ()).
另请参阅 isNull (), isEmpty ()，和 normalized ().
返回矩形左边缘的 X 坐标。相当于 x ().
另请参阅 setLeft (), topLeft ()，和 bottomLeft ().
返回矩形增长按 margins .
该函数在 Qt 5.1 引入。
另请参阅 operator+= (), marginsRemoved ()，和 operator-= ().
移除 margins 从矩形，收缩它。
该函数在 Qt 5.1 引入。
另请参阅 marginsAdded (), operator+= ()，和 operator-= ().
垂直移动矩形，使矩形底边线留在给定 y 坐标。矩形的大小保持不变。
另请参阅 bottom (), setBottom ()，和 moveTop ().
移动矩形，使左下角留在给定 position 。矩形的大小保持不变。
另请参阅 setBottomLeft (), moveBottom ()，和 moveLeft ().
移动矩形，使右下角留在给定 position 。矩形的大小保持不变。
另请参阅 setBottomRight (), moveRight ()，和 moveBottom ().
移动矩形，使中心点位于给定 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 坐标。
注意：由于历史原因，此函数返回 left () + width () - 1；使用 x () + width () 以检索真正 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 ().
创建 CGRect 从 QRect .
该函数在 Qt 5.8 引入。
另请参阅 QRectF::fromCGRect ().
返回矩形上边缘的 Y 坐标。相当于 y ().
另请参阅 setTop (), topLeft ()，和 topRight ().
返回矩形左上角的位置。
另请参阅 setTopLeft (), top ()，和 left ().
返回矩形右上角的位置。
注意：由于历史原因，此函数返回 QPoint ( left () + width () -1, top ()).
另请参阅 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 轴，相对当前位置。
返回交换了宽度和高度的矩形副本：
QRect r = {15, 51, 42, 24}; r = r.transposed(); // r == {15, 51, 24, 42}
该函数在 Qt 5.7 引入。
另请参阅 QSize::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.1 引入。
另请参阅 marginsAdded (), marginsRemoved ()，和 operator-= ().
返回矩形的收缩按 margins .
该函数在 Qt 5.1 引入。
另请参阅 marginsRemoved (), operator+= ()，和 marginsAdded ().
返回边界矩形为此矩形和给定 rectangle .
另请参阅 operator|= () 和 united ().
联合此矩形与给定 rectangle .
另请参阅 united () 和 operator| ().
返回
true
若矩形
r1
and
r2
不同，否则返回
false
.
返回 rectangle 增长按 margins .
该函数在 Qt 5.1 引入。
这是重载函数。
返回 rectangle 增长按 margins .
该函数在 Qt 5.1 引入。
返回 lhs rectangle shrunk by the rhs 边距。
该函数在 Qt 5.3 引入。
写入给定 rectangle 到给定 stream ，并返回流引用。
另请参阅 序列化 Qt 数据类型 .
返回
true
若矩形
r1
and
r2
相等，否则返回
false
.
读取矩形从给定 stream 进给定 rectangle ，并返回流引用。
另请参阅 序列化 Qt 数据类型 .
