QPointF Class

QPointF クラスは、浮動小数点精度を使用して平面上の点を定義します。詳細...

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

このクラスは等価比較可能です。

このクラスはQPoint等価比較可能です。

注意:このクラスの関数はすべてリエントラントです。

パブリック関数

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)
(since 6.8) bool qFuzzyCompare(const QPointF &p1, const QPointF &p2)
(since 6.8) bool qFuzzyIsNull(const QPointF &point)
bool operator!=(const QPointF &lhs, const QPointF &rhs)
QPointF operator*(const QPointF &point, qreal factor)
QPointF operator*(qreal factor, const QPointF &point)
QPointF operator+(const QPointF &point)
QPointF operator+(const QPointF &p1, const QPointF &p2)
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 &lhs, const QPointF &rhs)
QDataStream &operator>>(QDataStream &stream, QPointF &point)

詳細説明

点は x 座標と y 座標で指定され、x() とy() 関数を使用してアクセスできます。点の座標は、正確を期すために有限浮動小数点数を用いて指定される。x と y の両方が 0.0 に設定されている場合、isNull() 関数はtrue を返す。座標を設定(変更)するには、setX ()関数とsetY ()関数を使用するか、rx ()関数とry ()関数を使用して座標への参照を返します(直接操作可能)。

p が与えられた場合、以下の記述はすべて等価です:

QPointF p;

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

QPointF オブジェクトはベクトルとしても使用できます:QPointF オブジェクトはベクトルとしても使用できます: 加算と減算はベクトルと同様に定義されます(各成分は別々に加算されます)。QPointF オブジェクトは、int またはqreal によって分割または乗算することもできます。

さらに QPointF クラスは、QPoint オブジェクトを QPointF オブジェクトに変換するコンストラクタと、この点のQPoint コピーを返す対応するtoPoint() 関数を提供します。最後に、QPointFオブジェクトは比較だけでなく、ストリームすることもできる。

QPoint およびQPolygonFも参照のこと

メンバ関数ドキュメント

[constexpr noexcept] QPointF::QPointF()

ヌル点(座標 (0.0, 0.0))を構築する。

isNull()も参照

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

与えられたpoint のコピーを構築します。

toPoint() およびQPoint::toPointF() も参照

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

p1p2 のドット積を返します。

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

CGPointpoint からQRectF を作成します。

toCGPoint()も参照して ください。

[noexcept] bool QPointF::isNull() const

x 座標と y 座標の両方が 0.0 に設定されている場合はtrue を返します(符号は無視されます)。それ以外の場合はfalse を返します。

[constexpr] qreal QPointF::manhattanLength() const

x() とy() の絶対値の和を返します。これは、伝統的に原点から点までのベクトルの「マンハッタン長」として知られています。

QPoint::manhattanLength()も参照

[constexpr noexcept] qreal &QPointF::rx()

この点の x 座標への参照を返します。

参照を使用すると、x を直接操作できるようになります:

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

x() およびsetX() も参照

[constexpr noexcept] qreal &QPointF::ry()

この点の y 座標への参照を返します。

参照を使用すると、y を直接操作できるようになる:

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

y() およびsetY() も参照

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

この点の x 座標を、与えられた有限座標x に設定します。

x() およびsetY() も参照

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

この点の y 座標を、与えられた有限のy 座標に設定します。

y() およびsetX() も参照

[noexcept] CGPoint QPointF::toCGPoint() const

QPointF から CGPoint を作成します。

fromCGPoint()も参照

[constexpr] QPoint QPointF::toPoint() const

この点の座標を最も近い整数に丸め、丸めた座標を持つQPoint オブジェクトを返します。

QPointF() およびQPoint::toPointF()も参照

[constexpr noexcept] QPointF QPointF::transposed() const

x 座標と y 座標を交換した点を返します:

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

x()、y()、setX() およびsetY() も参照

[constexpr noexcept] qreal QPointF::x() const

この点の x 座標を返します。

setX() およびrx()も参照

[constexpr noexcept] qreal QPointF::y() const

この点の y 座標を返します。

setY() およびry() も参照

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

この点の座標に与えられた有限値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)

divisor はゼロまたは NaN であってはならない。

operator*=()も参照

関連する非会員

[constexpr noexcept, since 6.8] bool qFuzzyCompare(const QPointF &p1, const QPointF &p2)

p1p2 とほぼ等しい場合はtrue を返し、そうでない場合はfalse を返します。

この関数は Qt 6.8 で導入されました。

qFuzzyIsNullも参照してください

[constexpr noexcept, since 6.8] bool qFuzzyIsNull(const QPointF &point)

point が点(0.0, 0.0) にほぼ等しい場合はtrue を返します。

この関数は Qt 6.8 で導入されました。

qFuzzyCompareも参照して ください

[constexpr noexcept] bool operator!=(const QPointF &lhs, const QPointF &rhs)

lhsrhs と十分に異なる場合はtrue を返し、そうでない場合はfalse を返します。

警告 この関数は厳密な不等式をチェックしません。代わりに、ファジー比較を使って点の座標を比較します。

qFuzzyCompareも参照のこと

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

与えられたpoint に与えられた有限のfactor を掛けたコピーを返す。

QPointF::operator*=() も参照

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

これはオーバーロードされた関数です。

与えられたpoint のコピーに、与えられた有限のfactor を掛けたものを返す。

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

point を変更せずに返す。

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

与えられた点p1p2 の和であるQPointF オブジェクトを返します。

QPointF::operator+=()も参照

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

p1 からp2 を減算したQPointF オブジェクトを返す。

QPointF::operator-=()も参照の こと。

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

これはオーバーロードされた関数である。

与えられたpoint の各要素の符号を変更したQPointF オブジェクトを返す。

QPointF(0,0) - point と同等。

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

与えられたpoint の各成分を与えられたdivisor で割ったQPointF オブジェクトを返す。

divisor はゼロまたは NaN であってはならない。

QPointF::operator/=()も参照のこと

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

与えられたpoint を与えられたstream に書き込み、そのストリームへの参照を返します。

Qt データ型のシリアライズ」も参照して ください。

[constexpr noexcept] bool operator==(const QPointF &lhs, const QPointF &rhs)

lhsrhs とほぼ等しい場合はtrue を返し、そうでない場合はfalse を返します。

警告 この関数は厳密に等しいかどうかをチェックするのではなく、ファジー比較を使って点の座標を比較します。

qFuzzyCompareも参照

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

与えられたstream から与えられたpoint に点を読み込み、ストリームへの参照を返します。

Qt データ型のシリアライズ」も参照して ください。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。