内容

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

QPointF 类

QPointF 类使用浮点精度定义平面点。 更多...

头：	#include <QPointF>
CMake:	find_package(Qt6 COMPONENTS Core REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake:	QT += core

• 所有成员列表，包括继承成员

注意： 此类的所有函数 可重入 .

公共函数

	QPointF (qreal xpos , qreal ypos )
	QPointF (const QPoint & point )
	QPointF ()
bool	isNull () const
qreal	manhattanLength () const
qreal &	rx ()
qreal &	ry ()
void	setX (qreal x )
void	setY (qreal y )
CGPoint	toCGPoint () const
QPoint	toPoint () const
QPointF	transposed () const
qreal	x () const
qreal	y () const
QPointF &	operator*= (qreal factor )
QPointF &	operator+= (const QPointF & point )
QPointF &	operator-= (const QPointF & point )
QPointF &	operator/= (qreal divisor )

静态公共成员

qreal	dotProduct (const QPointF & p1 , const QPointF & p2 )
QPointF	fromCGPoint (CGPoint point )

相关非成员

bool	operator!= (const QPointF & p1 , const QPointF & p2 )
QPointF	operator* (const QPointF & point , qreal factor )
QPointF	operator* (qreal factor , const QPointF & point )
QPointF	operator+ (const QPointF & p1 , const QPointF & p2 )
QPointF	operator+ (const QPointF & point )
QPointF	operator- (const QPointF & p1 , const QPointF & p2 )
QPointF	operator- (const QPointF & point )
QPointF	operator/ (const QPointF & point , qreal divisor )
QDataStream &	operator<< (QDataStream & stream , const QPointF & point )
bool	operator== (const QPointF & p1 , const QPointF & p2 )
QDataStream &	operator>> (QDataStream & stream , QPointF & point )

详细描述

点是通过 X 坐标和 Y 坐标指定，可以访问使用 x () 和 y () 函数。为准确起见，使用有限浮点数指定点坐标。 isNull () 函数返回 true 若 X 和 Y 两者被设为 0.0。可以设置 (或变更) 坐标使用 setX () 和 setY () 函数，或另外的 rx () 和 ry () 函数返回坐标引用 (允许直接操纵)。

给定点 p ，下列语句全部等效：

QPointF p;
p.setX(p.x() + 1.0);
p += QPointF(1.0, 0.0);
p.rx()++;
					

QPointF 对象还可以用作向量：有为向量 (每个分量各自相加) 定义加法和减法。QPointF 对象也可以除以或乘以 int 或 qreal .

此外，QPointF 类提供构造函数转换 QPoint object into a QPointF object, and a corresponding toPoint () 函数返回 QPoint 副本为 this point. Finally, QPointF objects can be streamed as well as compared.

另请参阅 QPoint and QPolygonF .

成员函数文档编制

QPointF:: QPointF ( qreal xpos , qreal ypos )

构造点采用给定坐标 ( xpos , ypos ).

另请参阅 setX () 和 setY ().

QPointF:: QPointF (const QPoint & point )

构造副本为给定 point .

另请参阅 toPoint ().

QPointF:: QPointF ()

构造 null 点，即具有坐标 (0.0, 0.0)

另请参阅 isNull ().

[static, since 5.1] qreal QPointF:: dotProduct (const QPointF & p1 , const QPointF & p2 )

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
int lengthSquared = QPointF::dotProduct(p, q);   // lengthSquared becomes 26.01
					

返回点积为 p1 and p2 .

该函数在 Qt 5.1 引入。

[static, since 5.8] QPointF QPointF:: fromCGPoint ( CGPoint point )

创建 QRectF 从 CGPoint point .

该函数在 Qt 5.8 引入。

另请参阅 toCGPoint ().

bool QPointF:: isNull () const

返回 true 若 X 和 Y 坐标两者被设为 0.0 (忽略符号); 否则返回 false .

qreal QPointF:: manhattanLength () const

返回绝对值的和对于 x () 和 y ()，传统上称为从原点到点的 "曼哈顿长度" 向量。

另请参阅 QPoint::manhattanLength ().

qreal &QPointF:: rx ()

返回此点的 X 坐标引用。

使用引用使之可能直接操纵 X。例如：

 QPointF p(1.1, 2.5);
 p.rx()--;   // p becomes (0.1, 2.5)
					

另请参阅 x () 和 setX ().

qreal &QPointF:: ry ()

返回此点的 Y 坐标引用。

使用引用使之可能直接操纵 Y。例如：

QPointF p(1.1, 2.5);
p.ry()++;   // p becomes (1.1, 3.5)
					

另请参阅 y () 和 setY ().

void QPointF:: setX ( qreal x )

将此点的 X 坐标设为给定有限 x 坐标。

另请参阅 x () 和 setY ().

void QPointF:: setY ( qreal y )

将此点的 Y 坐标设为给定有限 y 坐标。

另请参阅 y () 和 setX ().

[since 5.8] CGPoint QPointF:: toCGPoint () const

创建 CGPoint 从 QPointF .

该函数在 Qt 5.8 引入。

另请参阅 fromCGPoint ().

QPoint QPointF:: toPoint () const

将此点的坐标舍入到最近整数，并返回 QPoint 对象具有舍入坐标。

另请参阅 QPointF ().

[since 5.14] QPointF QPointF:: transposed () const

返回具有 x 和 y 交换坐标的点：

QPointF{1.0, 2.0}.transposed() // {2.0, 1.0}
					

该函数在 Qt 5.14 引入。

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

qreal QPointF:: x () const

返回此点的 X 坐标。

另请参阅 setX () 和 rx ().

qreal QPointF:: y () const

返回此点的 Y 坐标。

另请参阅 setY () 和 ry ().

QPointF &QPointF:: operator*= ( qreal factor )

此点的坐标乘以给定有限 factor ，并返回此点的引用。例如：

QPointF p(-1.1, 4.1);
p *= 2.5;    // p becomes (-2.75, 10.25)
					

另请参阅 operator/= ().

QPointF &QPointF:: operator+= (const QPointF & point )

添加给定 point 到此点并返回此点的引用。例如：

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p += q;    // p becomes (2.1, 11.2)
					

另请参阅 operator-= ().

QPointF &QPointF:: operator-= (const QPointF & point )

减去给定 point 从此点并返回此点的引用。例如：

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p -= q;    // p becomes (4.1, 3.0)
					

另请参阅 operator+= ().

QPointF &QPointF:: operator/= ( qreal divisor )

X 和 Y 两者除以给定 divisor ，并返回此点的引用。例如：

QPointF p(-2.75, 10.25);
p /= 2.5;           // p becomes (-1.1, 4.1)
					

divisor must not be zero or NaN.

另请参阅 operator*= ().

相关非成员

bool operator!= (const QPointF & p1 , const QPointF & p2 )

返回 true if p1 is sufficiently different from p2 ；否则返回 false .

警告： This function does not check for strict inequality; instead, it uses a fuzzy comparison to compare the points' coordinates.

另请参阅 qFuzzyCompare .

QPointF operator* (const QPointF & point , qreal factor )

返回副本为给定 point ，乘以给定有限 factor .

另请参阅 QPointF::operator*= ().

QPointF operator* ( qreal factor , const QPointF & point )

这是重载函数。

返回副本为给定 point ，乘以给定有限 factor .

QPointF operator+ (const QPointF & p1 , const QPointF & p2 )

返回 QPointF 对象是和对于给定点 p1 and p2 ；分别相加各分量。

另请参阅 QPointF::operator+= ().

[since 5.0] QPointF operator+ (const QPointF & point )

返回 point 未经修改。

该函数在 Qt 5.0 引入。

QPointF operator- (const QPointF & p1 , const QPointF & p2 )

返回 QPointF 对象的形成是通过减去 p2 from p1 ；分别减去各分量。

另请参阅 QPointF::operator-= ().

QPointF operator- (const QPointF & point )

这是重载函数。

返回 QPointF object that is formed by changing the sign of each component of the given point .

相当于 QPointF(0,0) - point .

QPointF operator/ (const QPointF & point , qreal divisor )

返回 QPointF object formed by dividing each component of the given point 通过给定 divisor .

divisor must not be zero or NaN.

另请参阅 QPointF::operator/= ().

QDataStream & operator<< ( QDataStream & stream , const QPointF & point )

写入给定 point 到给定 stream 并返回流引用。

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

bool operator== (const QPointF & p1 , const QPointF & p2 )

返回 true if p1 is approximately equal to p2 ；否则返回 false .

警告： This function does not check for strict equality; instead, it uses a fuzzy comparison to compare the points' coordinates.

另请参阅 qFuzzyCompare .

QDataStream & operator>> ( QDataStream & stream , QPointF & point )

读取点从给定 stream 进给定 point 并返回流引用。

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