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*=()も参照 。