QPointF Class
QPointF クラスは、浮動小数点精度を使用して平面上の点を定義します。詳細...
Header: | #include <QPointF> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
- 継承メンバを含む全メンバ一覧
- QPointF は絵画クラスの一部です。
このクラスは等価比較可能です。
このクラスは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 オブジェクトはベクトルとしても使用できます:QPointF オブジェクトはベクトルとしても使用できます: 加算と減算はベクトルと同様に定義されます(各成分は別々に加算されます)。QPointF オブジェクトは、int
またはqreal
によって分割または乗算することもできます。
さらに QPointF クラスは、QPoint オブジェクトを QPointF オブジェクトに変換するコンストラクタと、この点のQPoint コピーを返す対応するtoPoint() 関数を提供します。最後に、QPointFオブジェクトは比較だけでなく、ストリームすることもできる。
メンバ関数ドキュメント
[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) を持つ点を構築します。
[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 とp2 のドット積を返します。
[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)
[constexpr noexcept]
qreal &QPointF::ry()
この点の y 座標への参照を返します。
参照を使用すると、y を直接操作できるようになる:
QPointF p(1.1, 2.5); p.ry()++; // p becomes (1.1, 3.5)
[constexpr noexcept]
void QPointF::setX(qreal x)
この点の x 座標を、与えられた有限座標x に設定します。
[constexpr noexcept]
void QPointF::setY(qreal y)
この点の y 座標を、与えられた有限のy 座標に設定します。
[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 座標を返します。
[constexpr noexcept]
qreal QPointF::y() const
この点の y 座標を返します。
[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 を加算し、この点への参照を返します。例えば
operator-=()も参照 。
[constexpr]
QPointF &QPointF::operator-=(const QPointF &point)
この点から与えられたpoint を引いて、この点への参照を返す。例えば
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)
p1 がp2 とほぼ等しい場合は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)
lhs がrhs と十分に異なる場合は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)
与えられた点p1 とp2 の和である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)
lhs がrhs とほぼ等しい場合は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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。