QPointF Class

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

ヘッダー #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)

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

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

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

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

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

qFuzzyCompareも参照

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

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

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

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.