头: | #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 ) |
QRect 类使用整数精度,定义平面矩形。
A rectangle is normally expressed as an upper-left corner and a size. The size (width and height) of a QRect is always equivalent to the mathematical rectangle that forms the basis for its rendering.
A QRect can be constructed with a set of left, top, width and height integers, or from a QPoint 和 QSize 。以下代码创建 2 个恒等矩形。
QRect r1(100, 200, 11, 16); QRect r2(QPoint(100, 200), QSize(11, 16));
There is a third constructor that creates a QRect using the top-left and bottom-right coordinates, but we recommend that you avoid using it. The rationale is that for historical reasons the values returned by the bottom () 和 right () 函数偏离矩形的真正右下角。
QRect class provides a collection of functions that return the various rectangle coordinates, and enable manipulation of these. QRect 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 QSize 。还可以单独检索尺度使用 width () 和 height () 函数。要操纵维度使用 setSize (), setWidth () 或 setHeight () 函数。另外,通过应用设置矩形坐标的函数可以改变大小,例如 setBottom () 或 setRight ().
contains
() 函数告诉给定点是否在矩形内,和
intersects
() 函数返回
true
if this rectangle intersects with a given rectangle. The
QRect
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
left
() >
right
() 或
top
() >
bottom
(). Note that an empty rectangle is not valid: The
isValid
() 函数返回
true
if
left
() <=
right
()
and
top
() <=
bottom
(). 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 QRect is defined in essentially the same way as QRectF .
最后, QRect 对象可以被流化及比较。
当使用 anti-aliased painter, the boundary line of a QRect 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 QRect '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 像素宽钢笔 |
QRect class provides a collection of functions that return the various rectangle coordinates, and enable manipulation of these. QRect also provide functions to move the rectangle relative to the various coordinates.
For example the left (), setLeft () 和 moveLeft () functions as an example: left () returns the x-coordinate of the rectangle's left edge, setLeft () sets the left edge of the rectangle to the given x coordinate (it may change the width, but will never change the rectangle's right edge) and moveLeft () moves the entire rectangle horizontally, leaving the rectangle's left edge at the given x coordinate and its size unchanged.
Note that for historical reasons the values returned by the bottom () 和 right () functions deviate from the true bottom-right corner of the rectangle: The right () 函数返回 left () + width () - 1 和 bottom () 函数返回 top () + height () - 1 . The same is the case for the point returned by the bottomRight () convenience function. In addition, the x and y coordinate of the topRight () 和 bottomLeft () functions, respectively, contain the same deviation from the true right and bottom edges.
We recommend that you use x () + width () 和 y () + height () to find the true bottom-right corner, and avoid right () 和 bottom (). Another solution is to use QRectF : The QRectF class defines a rectangle in the plane using floating point accuracy for coordinates, and the QRectF::right () 和 QRectF::bottom () 函数 do return the right and bottom coordinates.
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 () 函数能检索角被交换的矩形。
此外, QRect 提供 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.
QRect
is limited to the minimum and maximum values for the
int
type. Operations on a
QRect
that could potentially result in values outside this range will result in undefined behavior.
构造 null 矩形。
另请参阅 isNull ().
构造矩形采用给定 topLeft and bottomRight 角。
另请参阅 setTopLeft () 和 setBottomRight ().
构造矩形采用给定 topLeft 角和给定 size .
另请参阅 setTopLeft () 和 setSize ().
构造矩形采用 ( x , y ) 作为其左上角和给定 width and height .
另请参阅 setRect ().
添加 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 坐标。
注意:由于历史原因,此函数返回 top () + height () - 1;使用 y () + height () 去检索为 true 的 y 坐标。
另请参阅 setBottom (), bottomLeft (),和 bottomRight ().
Returns the position of the rectangle's bottom-left corner. Note that for historical reasons this function returns QPoint ( left (), top () + height () - 1).
另请参阅 setBottomLeft (), bottom (),和 left ().
返回矩形右下角的位置。
注意:由于历史原因,此函数返回 QPoint ( left () + width () -1, top () + height () - 1).
另请参阅 setBottomRight (), bottom (),和 right ().
返回矩形的中心点。
另请参阅 moveCenter ().
返回
true
若给定
point
在矩形内或边缘,否则返回
false
。若
proper
is true, this function only returns
true
若给定
point
is
inside
the rectangle (i.e., not on the edge).
另请参阅 intersects ().
这是重载函数。
返回
true
若给定
rectangle
在此矩形内。否则返回
false
。若
proper
is true, this function only returns
true
若
rectangle
is entirely inside this rectangle (not on the edge).
这是重载函数。
返回
true
若点 (
x
,
y
) 在此矩形内,否则返回
false
.
这是重载函数。
返回
true
若点 (
x
,
y
) is inside or on the edge of the rectangle, otherwise returns
false
。若
proper
is true, this function only returns
true
if the point is entirely inside the rectangle(not on the edge).
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
(i.e., there is at least one pixel that is within both rectangles), otherwise returns
false
.
可以检索交集矩形使用 intersected () 函数。
另请参阅 contains ().
返回
true
若矩形为空,否则返回
false
.
空矩形拥有 left () > right () 或 top () > bottom (). An empty rectangle is not valid (i.e., isEmpty() == ! isValid ()).
使用 normalized () 函数能检索角被交换的矩形。
另请参阅 isNull (), isValid (),和 normalized ().
返回
true
若矩形是 null 矩形,否则返回
false
.
A null rectangle has both the width and the height set to 0 (i.e., right () == left () - 1 and bottom () == top () - 1). A null rectangle is also empty, and hence is not valid.
返回
true
若矩形有效,否则返回
false
.
有效矩形拥有 left () <= right () 和 top () <= bottom (). 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.1 引入。
另请参阅 operator+= (), marginsRemoved (),和 operator-= ().
移除 margins 从矩形,收缩它。
该函数在 Qt 5.1 引入。
另请参阅 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 (), moveRight (),和 moveBottom ().
移动矩形,使中心点位于给定 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 edge at the given y 坐标。矩形大小不变。
另请参阅 top (), setTop (),和 moveBottom ().
移动矩形,将左上角留在给定 position 。矩形大小不变。
另请参阅 setTopLeft (), moveTop (),和 moveLeft ().
移动矩形,将右上角留在给定 position 。矩形大小不变。
另请参阅 setTopRight (), moveTop (),和 moveRight ().
返回规范化矩形;即:矩形拥有非负值宽度和高度。
若 width () < 0 函数交换左右角,和它交换上下角若 height () < 0.
返回矩形右边的 X 坐标。
注意:由于历史原因,此函数返回 left () + width () - 1;使用 x () + width () to retrieve the true x-coordinate.
另请参阅 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 ().
创建 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 along the y axis, relative to the current position. Positive values move the rectangle to the right and down.
另请参阅 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.
返回交换了宽度和高度的矩形副本:
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 grown by the margins .
该函数在 Qt 5.1 引入。
这是重载函数。
返回 rectangle grown by the margins .
该函数在 Qt 5.1 引入。
返回 lhs rectangle shrunken by the rhs 边距。
该函数在 Qt 5.3 引入。
写入给定 rectangle 到给定 stream ,并返回流引用。
另请参阅 序列化 Qt 数据类型 .
返回
true
若矩形
r1
and
r2
相等,否则返回
false
.
Reads a rectangle from the given stream 进给定 rectangle ,并返回流引用。
另请参阅 序列化 Qt 数据类型 .