QPointF 類

QPointF 類使用浮點精度定義平麵點。 更多...

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

注意: 此類的所有函數 可重入 .

公共函數

QPointF ()
QPointF (const QPoint & point )
QPointF (qreal xpos , qreal ypos )
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 () functions. The coordinates of the point are specified using finite floating point numbers for accuracy. The 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 .

成員函數文檔編製

[constexpr] QPointF:: QPointF ()

構造 null 點,即具有坐標 (0.0, 0.0)

另請參閱 isNull ().

[constexpr] QPointF:: QPointF (const QPoint & point )

構造副本為給定 point .

另請參閱 toPoint () 和 QPoint::toPointF ().

[constexpr] QPointF:: QPointF ( qreal xpos , qreal ypos )

構造點采用給定坐標 ( xpos , ypos ).

另請參閱 setX () 和 setY ().

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

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

返迴點積為 p1 and p2 .

[static] QPointF QPointF:: fromCGPoint ( CGPoint point )

創建 QRectF 從 CGPoint point .

另請參閱 toCGPoint ().

bool QPointF:: isNull () const

返迴 true 若 X 和 Y 坐標兩者被設為 0.0 (忽略符號); 否則返迴 false .

[constexpr] qreal QPointF:: manhattanLength () const

返迴絕對值的和對於 x () 和 y (),傳統上稱為從原點到點的 "曼哈頓長度" 嚮量。

另請參閱 QPoint::manhattanLength ().

[constexpr] qreal &QPointF:: rx ()

返迴此點的 X 坐標引用。

使用引用使之可能直接操縱 X。例如:

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

另請參閱 x () 和 setX ().

[constexpr] qreal &QPointF:: ry ()

返迴此點的 Y 坐標引用。

使用引用使之可能直接操縱 Y。例如:

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

另請參閱 y () 和 setY ().

[constexpr] void QPointF:: setX ( qreal x )

Sets the x coordinate of this point to the given finite x 坐標。

另請參閱 x () 和 setY ().

[constexpr] void QPointF:: setY ( qreal y )

Sets the y coordinate of this point to the given finite y 坐標。

另請參閱 y () 和 setX ().

CGPoint QPointF:: toCGPoint () const

創建 CGPoint 從 QPointF .

另請參閱 fromCGPoint ().

[constexpr] QPoint QPointF:: toPoint () const

將此點的坐標捨入到最近整數,並返迴 QPoint 對象具有捨入坐標。

另請參閱 QPointF () 和 QPoint::toPointF ().

[constexpr] QPointF QPointF:: transposed () const

返迴具有 x 和 y 交換坐標的點:

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

另請參閱 x (), y (), setX (),和 setY ().

[constexpr] qreal QPointF:: x () const

返迴此點的 X 坐標。

另請參閱 setX () 和 rx ().

[constexpr] qreal QPointF:: y () const

返迴此點的 Y 坐標。

另請參閱 setY () 和 ry ().

[constexpr] QPointF &QPointF:: operator*= ( qreal factor )

Multiplies this point's coordinates by the given finite factor ,並返迴此點的引用。例如:

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

另請參閱 operator/= ().

[constexpr] 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-= ().

[constexpr] 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+= ().

[constexpr] QPointF &QPointF:: operator/= ( qreal divisor )

X 和 Y 兩者除以給定 divisor ,並返迴此點的引用。例如:

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

The divisor must not be zero or NaN.

另請參閱 operator*= ().

相關非成員

[constexpr] 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 .

[constexpr] QPointF operator* (const QPointF & point , qreal factor )

返迴副本為給定 point , multiplied by the given finite factor .

另請參閱 QPointF::operator*= ().

[constexpr] QPointF operator* ( qreal factor , const QPointF & point )

這是重載函數。

返迴副本為給定 point , multiplied by the given finite factor .

[constexpr] QPointF operator+ (const QPointF & p1 , const QPointF & p2 )

返迴 QPointF 對象是和對於給定點 p1 and p2 ;各分量分彆相加。

另請參閱 QPointF::operator+= ().

[constexpr] QPointF operator+ (const QPointF & point )

返迴 point 未經修改。

[constexpr] QPointF operator- (const QPointF & p1 , const QPointF & p2 )

返迴 QPointF 對象的形成是通過減去 p2 from p1 ;分彆減去各分量。

另請參閱 QPointF::operator-= ().

[constexpr] 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 .

[constexpr] QPointF operator/ (const QPointF & point , qreal divisor )

返迴 QPointF object formed by dividing each component of the given point 通過給定 divisor .

The divisor must not be zero or NaN.

另請參閱 QPointF::operator/= ().

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

寫入給定 point 到給定 stream 並返迴流引用。

另請參閱 序列化 Qt 數據類型 .

[constexpr] 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 數據類型 .