QPoint 类

成员函数文档

[constexpr noexcept] QPoint::QPoint()

构造一个空点，即（0, 0）坐标

另请参阅isNull()。

[constexpr noexcept] QPoint::QPoint(int 横坐标, int 纵坐标)

使用指定的坐标（《横坐标》，《纵坐标》）构造一个点。

另请参阅setX() 和 setY()。

[static constexpr] int QPoint::dotProduct(const QPoint &我1, const QPoint &我2)

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

返回 我1 和 我2 的点积。

[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*=(float factor)

将此点的坐标乘以给定的 factor，并返回此点的引用。

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

另请参阅 operator/=()。

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

将此点的坐标乘以给定的 factor，并返回此点的引用。例如

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

注意，由于点是以整数形式存储的，结果会四舍五入到最接近的整数。请使用 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*=。