QPoint Class

メンバ関数ドキュメント

[constexpr noexcept] QPoint::QPoint()

ヌル点（座標 (0, 0)）を構築する。

isNull()も参照 。

[constexpr noexcept] QPoint::QPoint(int xpos, int ypos)

与えられた座標 (xpos,ypos) を持つ点を構築する。

setX() およびsetY()も参照 。

[static constexpr] int QPoint::dotProduct(const QPoint &p1, const QPoint &p2)

QPoint p( 3, 7);
QPoint q(-1, 4);
int dotProduct = QPoint::dotProduct(p, q);   // dotProduct becomes 25

p1 とp2 のドット積を返します。

[constexpr noexcept] bool QPoint::isNull() const

x 座標と y 座標の両方が 0 に設定されている場合はtrue を返し、そうでない場合はfalse を返します。

[constexpr] int QPoint::manhattanLength() const

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

QPoint oldPosition;

MyWidget::mouseMoveEvent(QMouseEvent *event)
{
    QPoint point = event->pos() - oldPosition;
    if (point.manhattanLength() > 3)
        // the mouse has moved more than 3 pixels since the oldPosition
}

これは、真の長さの近似値として便利であり、すぐに計算できる：

double trueLength = std::sqrt(std::pow(x(), 2) + std::pow(y(), 2));

マンハッタン長」の伝統は、このような距離が、マンハッタンの通りのような長方形のグリッド上でしか移動できない旅行者に適用されることから生まれた。

[constexpr noexcept] int &QPoint::rx()

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

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

QPoint p(1, 2);
p.rx()--;   // p becomes (0, 2)

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

[constexpr noexcept] int &QPoint::ry()

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

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

QPoint p(1, 2);
p.ry()++;   // p becomes (1, 3)

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

[constexpr noexcept] void QPoint::setX(int x)

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

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

[constexpr noexcept] void QPoint::setY(int y)

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

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

[noexcept] CGPoint QPoint::toCGPoint() const

QPoint から CGPoint を作成します。

QPointF::fromCGPoint()も参照 。

[constexpr noexcept, since 6.4] QPointF QPoint::toPointF() const

この点を浮動小数点精度の点として返します。

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

QPointF::toPoint()も参照して ください。

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

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

QPoint{1, 2}.transposed() // {2, 1}

x(),y(),setX(),setY()も参照 。

[constexpr noexcept] int QPoint::x() const

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

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

[constexpr noexcept] int QPoint::y() const

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

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

[constexpr] QPoint &QPoint::operator*=(double factor)

この点の座標に指定されたfactor を乗算し、この点への参照を返します。例えば

QPoint p(-1, 4);
p *= 2.5;    // p becomes (-3, 10)

点は整数として保持されるので、結果は最も近い整数に丸められることに注意してください。浮動小数点精度の場合はQPointF を使用します。

operator/=()も参照 。

[constexpr] QPoint &QPoint::operator*=(float factor)

この点の座標に与えられたfactor を掛け算し、この点への参照を返します。

点は整数として保持されるので、結果は最も近い整数に丸められることに注意してください。浮動小数点精度の場合はQPointF を使用します。

operator/=()も参照 。

[constexpr] QPoint &QPoint::operator*=(int factor)

この点の座標に与えられたfactor を乗算し、この点への参照を返します。

operator/=()も参照して ください。

[constexpr] QPoint &QPoint::operator+=(const QPoint &point)

与えられたpoint をこの点に加算し、この点への参照を返します。例えば

QPoint p( 3, 7);
QPoint q(-1, 4);
p += q;    // p becomes (2, 11)

operator-=()も参照 。

[constexpr] QPoint &QPoint::operator-=(const QPoint &point)

この点から指定されたpoint を引いて、この点への参照を返す。例えば

QPoint p( 3, 7);
QPoint q(-1, 4);
p -= q;    // p becomes (4, 3)

operator+=() も参照 。

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

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

x と y の両方を与えられたdivisor で割り、この点への参照を返します。例えば

QPoint p(-3, 10);
p /= 2.5;           // p becomes (-1, 4)

点は整数として保持されるので、結果は最も近い整数に丸められることに注意してください。浮動小数点精度の場合はQPointF を使用してください。

operator*=()も参照 。