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