QPointF 類

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

頭: #include <QPointF>
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
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 )
const QPointF operator* (const QPointF & point , qreal factor )
const QPointF operator* (qreal factor , const QPointF & point )
const QPointF operator+ (const QPointF & p1 , const QPointF & p2 )
const QPointF operator+ (const QPointF & point )
const QPointF operator- (const QPointF & p1 , const QPointF & p2 )
const QPointF operator- (const QPointF & point )
const 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 )

詳細描述

The QPointF 類使用浮點精度定義平麵點。

點是通過 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()++;
					

A QPointF 對象還可以用作嚮量:有為嚮量 (每個分量各自相加) 定義加法和減法。 QPointF 對象也可以除以或乘以 int qreal .

此外, QPointF 類提供構造函數轉換 QPoint 對象成 QPointF 對象,和相應 toPoint () 函數返迴 QPoint 副本為 this 點。最後, QPointF 對象可以被流化及比較。

另請參閱 QPoint and QPolygonF .

成員函數文檔編製

QPointF:: QPointF ()

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

另請參閱 isNull ().

QPointF:: QPointF (const QPoint & point )

構造副本為給定 point .

另請參閱 toPoint ().

QPointF:: QPointF ( qreal xpos , qreal ypos )

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

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

[static] 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] 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 (),傳統上稱為從原點到點的 "曼哈頓長度" 嚮量。

該函數在 Qt 4.6 引入。

另請參閱 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 ().

CGPoint QPointF:: toCGPoint () const

創建 CGPoint 從 QPointF .

該函數在 Qt 5.8 引入。

另請參閱 fromCGPoint ().

QPoint QPointF:: toPoint () const

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

另請參閱 QPointF ().

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)
					

另請參閱 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 .

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

返迴副本為給定 point ,乘以給定 factor .

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

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

這是重載函數。

返迴副本為給定 point ,乘以給定 factor .

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

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

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

const QPointF operator+ (const QPointF & point )

返迴 point 未經修改。

該函數在 Qt 5.0 引入。

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

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

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

const QPointF operator- (const QPointF & point )

這是重載函數。

返迴 QPointF 對象的形成是通過改變 2 分量的符號為給定 point .

相當於 QPointF(0,0) - point .

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

返迴 QPointF 形成對象通過除 2 分量為給定 point 通過給定 divisor .

另請參閱 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 數據類型 .