内容

• 公共函数
• 静态公共成员
• 相关非成员
• 详细描述
• 渲染
• 坐标

QRectF 类

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.

渲染

当使用 抗锯齿 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 () 函数能一次性操纵矩形的坐标和尺度。

另请参阅 QRect and QRegion .

成员函数文档编制

QRectF:: QRectF (const QRect & rectangle )

构造 QRectF 矩形从给定 QRect rectangle .

另请参阅 toRect ().

QRectF:: QRectF ( qreal x , qreal y , qreal width , qreal height )

构造矩形采用 ( x , y ) 作为其左上角和给定 width and height 。所有参数必须是有限的。

另请参阅 setRect ().

QRectF:: QRectF (const QPointF & topLeft , const QPointF & bottomRight )

构造矩形采用给定 topLeft and bottomRight 角。

另请参阅 setTopLeft () 和 setBottomRight ().

QRectF:: QRectF (const QPointF & topLeft , const QSizeF & size )

构造矩形采用给定 topLeft 角和给定 size .

另请参阅 setTopLeft () 和 setSize ().

QRectF:: QRectF ()

构造 null 矩形。

另请参阅 isNull ().

void QRectF:: adjust ( qreal dx1 , qreal dy1 , qreal dx2 , qreal dy2 )

添加 dx1 , dy1 , dx2 and dy2 respectively to the existing coordinates of the rectangle. All parameters must be finite.

另请参阅 adjusted () 和 setRect ().

QRectF QRectF:: adjusted ( qreal dx1 , qreal dy1 , qreal dx2 , qreal dy2 ) const

返回新的矩形采用 dx1 , dy1 , dx2 and dy2 added respectively to the existing coordinates of this rectangle. All parameters must be finite.

另请参阅 adjust ().

qreal QRectF:: bottom () const

返回矩形底部边缘的 Y 坐标。

另请参阅 setBottom (), bottomLeft ()，和 bottomRight ().

QPointF QRectF:: bottomLeft () const

返回矩形左下角位置。

另请参阅 setBottomLeft (), bottom ()，和 left ().

QPointF QRectF:: bottomRight () const

返回矩形右下角的位置。

另请参阅 setBottomRight (), bottom ()，和 right ().

QPointF QRectF:: center () const

返回矩形的中心点。

另请参阅 moveCenter ().

bool QRectF:: contains (const QPointF & point ) const

返回 true 若给定 point 在矩形内或边缘；否则返回 false .

另请参阅 intersects ().

bool QRectF:: contains (const QRectF & rectangle ) const

这是重载函数。

返回 true 若给定 rectangle 在此矩形内；否则返回 false .

bool QRectF:: contains ( qreal x , qreal y ) const

这是重载函数。

返回 true 若点 ( x , y ) 在矩形内或边缘；否则返回 false .

[static, since 5.8] QRectF QRectF:: fromCGRect ( CGRect rect )

创建 QRectF 从 CGRect rect .

该函数在 Qt 5.8 引入。

另请参阅 toCGRect ().

void QRectF:: getCoords ( qreal * x1 , qreal * y1 , qreal * x2 , qreal * y2 ) const

将矩形左上角位置提取到 * x1 和 * y1 ，和右下角位置到 * x2 和 * y2 .

另请参阅 setCoords () 和 getRect ().

void QRectF:: getRect ( qreal * x , qreal * y , qreal * width , qreal * height ) const

将矩形左上角位置提取到 * x 和 * y ，和其尺度到 * width 和 * height .

另请参阅 setRect () 和 getCoords ().

qreal QRectF:: height () const

返回矩形的高度。

另请参阅 setHeight (), width ()，和 size ().

QRectF QRectF:: intersected (const QRectF & rectangle ) const

返回交集为此矩形和给定 rectangle 。注意， r.intersected(s) 相当于 r & s .

另请参阅 intersects (), united ()，和 operator&= ().

bool QRectF:: intersects (const QRectF & rectangle ) const

返回 true 若此矩形相交给定 rectangle (即：在它们之间存在非空重叠区域)，否则返回 false .

可以检索交集矩形使用 intersected () 函数。

另请参阅 contains ().

bool QRectF:: isEmpty () const

返回 true 若矩形为空，否则返回 false .

空矩形拥有 width () <= 0 或 height () <= 0。空矩形无效 (即：isEmpty() == ! isValid ()).

使用 normalized () 函数以检索角交换矩形。

另请参阅 isNull (), isValid ()，和 normalized ().

bool QRectF:: isNull () const

返回 true 若矩形是 null 矩形，否则返回 false .

null 矩形有将宽度和高度两者设为 0。null 矩形也为空，因此无效。

另请参阅 isEmpty () 和 isValid ().

bool QRectF:: isValid () const

返回 true 若矩形有效，否则返回 false .

有效矩形拥有 width () > 0 和 height () > 0。注意，非通俗操作 (像交集) 对于无效矩形未定义。有效矩形不为空 (即 isValid() == ! isEmpty ()).

另请参阅 isNull (), isEmpty ()，和 normalized ().

qreal QRectF:: left () const

返回矩形左边缘的 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-= ().

void QRectF:: moveBottom ( qreal y )

Moves the rectangle vertically, leaving the rectangle's bottom edge at the given finite y 坐标。矩形的大小保持不变。

另请参阅 bottom (), setBottom ()，和 moveTop ().

void QRectF:: moveBottomLeft (const QPointF & position )

移动矩形，使左下角留在给定 position 。矩形的大小保持不变。

另请参阅 setBottomLeft (), moveBottom ()，和 moveLeft ().

void QRectF:: moveBottomRight (const QPointF & position )

移动矩形，使右下角留在给定 position 。矩形的大小保持不变。

另请参阅 setBottomRight (), moveBottom ()，和 moveRight ().

void QRectF:: moveCenter (const QPointF & position )

移动矩形，使中心点位于给定 position 。矩形的大小保持不变。

另请参阅 center ().

void QRectF:: moveLeft ( qreal x )

水平移动矩形，使矩形左边缘留在给定有限 x 坐标。矩形的大小保持不变。

另请参阅 left (), setLeft ()，和 moveRight ().

void QRectF:: moveRight ( qreal x )

水平移动矩形，使矩形右边缘留在给定有限 x 坐标。矩形的大小保持不变。

另请参阅 right (), setRight ()，和 moveLeft ().

void QRectF:: moveTo ( qreal x , qreal y )

移动矩形，使左上角留在给定位置 ( x , y ). The rectangle's size is unchanged. Both parameters must be finite.

另请参阅 translate () 和 moveTopLeft ().

void QRectF:: moveTo (const QPointF & position )

这是重载函数。

移动矩形，使左上角留在给定 position .

void QRectF:: moveTop ( qreal y )

垂直移动矩形，使矩形上边线留在给定有限 y 坐标。矩形的大小保持不变。

另请参阅 top (), setTop ()，和 moveBottom ().

void QRectF:: moveTopLeft (const QPointF & position )

移动矩形，使左上角留在给定 position 。矩形的大小保持不变。

另请参阅 setTopLeft (), moveTop ()，和 moveLeft ().

void QRectF:: moveTopRight (const QPointF & position )

移动矩形，使右上角留在给定 position 。矩形的大小保持不变。

另请参阅 setTopRight (), moveTop ()，和 moveRight ().

QRectF QRectF:: normalized () const

返回规范化矩形；即：矩形拥有非负值宽度和高度。

若 width () < 0 函数交换左右角，和它交换上下角若 height () < 0.

另请参阅 isValid () 和 isEmpty ().

qreal QRectF:: right () const

返回矩形右边的 X 坐标。

另请参阅 setRight (), topRight ()，和 bottomRight ().

void QRectF:: setBottom ( qreal y )

Sets the bottom edge of the rectangle to the given finite y 坐标。可能改变高度，但从不会改变矩形的上边缘。

另请参阅 bottom () 和 moveBottom ().

void QRectF:: setBottomLeft (const QPointF & position )

将矩形左下角设为给定 position 。可能改变大小，但从不会改变矩形的右上角。

另请参阅 bottomLeft () 和 moveBottomLeft ().

void QRectF:: setBottomRight (const QPointF & position )

将矩形右下角设为给定 position 。可能改变大小，但从不改变矩形左上角。

另请参阅 bottomRight () 和 moveBottomRight ().

void QRectF:: setCoords ( qreal x1 , qreal y1 , qreal x2 , qreal y2 )

将矩形左上角坐标设为 ( x1 , y1 )，和它的右下角坐标到 ( x2 , y2 )。所有参数必须是有限的。

另请参阅 getCoords () 和 setRect ().

void QRectF:: setHeight ( qreal height )

Sets the height of the rectangle to the given finite height 。下边缘改变，但不改变上边缘。

另请参阅 height () 和 setSize ().

void QRectF:: setLeft ( qreal x )

Sets the left edge of the rectangle to the given finite x 坐标。可能改变宽度，但从不会改变矩形的右边缘。

相当于 setX ().

另请参阅 left () 和 moveLeft ().

void QRectF:: setRect ( qreal x , qreal y , qreal width , qreal height )

将矩形左上角坐标设为 ( x , y )，和它的大小到给定 width and height 。所有参数必须是有限的。

另请参阅 getRect () 和 setCoords ().

void QRectF:: setRight ( qreal x )

Sets the right edge of the rectangle to the given finite x 坐标。可能改变宽度，但从不会改变矩形的左边缘。

另请参阅 right () 和 moveRight ().

void QRectF:: setSize (const QSizeF & size )

Sets the size of the rectangle to the given finite size 。不移动左上角。

另请参阅 size (), setWidth ()，和 setHeight ().

void QRectF:: setTop ( qreal y )

Sets the top edge of the rectangle to the given finite y 坐标。可能改变高度，但从不会改变矩形的下边缘。

相当于 setY ().

另请参阅 top () 和 moveTop ().

void QRectF:: setTopLeft (const QPointF & position )

将矩形左上角设为给定 position 。可能改变大小，但从不改变矩形的右下角。

另请参阅 topLeft () 和 moveTopLeft ().

void QRectF:: setTopRight (const QPointF & position )

将矩形右上角设为给定 position 。可能改变大小，但从不改变矩形的右下角。

另请参阅 topRight () 和 moveTopRight ().

void QRectF:: setWidth ( qreal width )

Sets the width of the rectangle to the given finite width 。右边缘改变，但左边缘不改变。

另请参阅 width () 和 setSize ().

void QRectF:: setX ( qreal x )

Sets the left edge of the rectangle to the given finite x 坐标。可能改变宽度，但从不会改变矩形的右边缘。

相当于 setLeft ().

另请参阅 x (), setY ()，和 setTopLeft ().

void QRectF:: setY ( qreal y )

Sets the top edge of the rectangle to the given finite y 坐标。可能改变高度，但从不会改变矩形的下边缘。

相当于 setTop ().

另请参阅 y (), setX ()，和 setTopLeft ().

QSizeF QRectF:: size () const

返回矩形的大小。

另请参阅 setSize (), width ()，和 height ().

QRect QRectF:: toAlignedRect () const

返回 QRect 基于此矩形 (完全包含此矩形的最小可能整数矩形) 的值。

另请参阅 toRect ().

[since 5.8] CGRect QRectF:: toCGRect () const

创建 CGRect 从 QRectF .

该函数在 Qt 5.8 引入。

另请参阅 fromCGRect ().

QRect QRectF:: toRect () const

返回 QRect 基于此矩形的值。注意，返回矩形的坐标会被四舍五入到最近整数。

另请参阅 QRectF () 和 toAlignedRect ().

qreal QRectF:: top () const

返回矩形上边缘的 Y 坐标。相当于 y ().

另请参阅 setTop (), topLeft ()，和 topRight ().

QPointF QRectF:: topLeft () const

返回矩形左上角的位置。

另请参阅 setTopLeft (), top ()，和 left ().

QPointF QRectF:: topRight () const

返回矩形右上角的位置。

另请参阅 setTopRight (), top ()，和 right ().

void QRectF:: translate ( qreal dx , qreal dy )

移动矩形 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 ().

void QRectF:: translate (const QPointF & offset )

这是重载函数。

移动矩形 offset . x() 沿 X 轴和 offset . y() 沿 Y 轴，相对当前位置。

QRectF QRectF:: translated ( qreal dx , qreal dy ) const

返回的矩形副本有翻译 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 ().

QRectF QRectF:: translated (const QPointF & offset ) const

这是重载函数。

返回的矩形副本有翻译 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 ().

QRectF QRectF:: united (const QRectF & rectangle ) const

返回边界矩形为此矩形和给定 rectangle .

另请参阅 intersected ().

qreal QRectF:: width () const

返回矩形的宽度。

另请参阅 setWidth (), height ()，和 size ().

qreal QRectF:: x () const

返回矩形左边缘的 X 坐标。相当于 left ().

另请参阅 setX (), y ()，和 topLeft ().

qreal QRectF:: y () const

返回矩形上边缘的 Y 坐标。相当于 top ().

另请参阅 setY (), x ()，和 topLeft ().

QRectF QRectF:: operator& (const QRectF & rectangle ) const

返回交集为此矩形和给定 rectangle 。返回空矩形若没有交集。

另请参阅 operator&= () 和 intersected ().

QRectF &QRectF:: operator&= (const QRectF & rectangle )

相交此矩形与给定 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 ().

QRectF QRectF:: operator| (const QRectF & rectangle ) const

返回边界矩形为此矩形和给定 rectangle .

另请参阅 united () 和 operator|= ().

QRectF &QRectF:: operator|= (const QRectF & rectangle )

联合此矩形与给定 rectangle .

另请参阅 united () 和 operator| ().

相关非成员

bool operator!= (const QRectF & r1 , const QRectF & r2 )

返回 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 引入。

QDataStream & operator<< ( QDataStream & stream , const QRectF & rectangle )

写入 rectangle 到 stream ，并返回流引用。

另请参阅 序列化 Qt 数据类型 .

bool operator== (const QRectF & r1 , const QRectF & r2 )

返回 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 .

QDataStream & operator>> ( QDataStream & stream , QRectF & rectangle )

读取 rectangle 从 stream ，并返回流引用。

另请参阅 序列化 Qt 数据类型 .