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)

这是一个重载函数。

用给定的divisor 除以 x 和 y，并返回对该点的引用。例如

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

请注意，由于点是以整数形式保存的，因此结果会四舍五入为最接近的整数。使用QPointF 可获得浮点精度。

另请参阅 operator*=() 。