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;

void 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*=()も参照してください 。