概要 - Qt for Python

内容

警告

本部分包含从C++自动翻译为Python的代码片段,可能包含错误。

一个点由 x 坐标和 y 坐标指定,可以使用 x()y() 函数访问。isNull() 函数在 x 和 y 均设置为 0 时返回 true。可以使用 setX()setY() 函数设置(或更改)坐标,或者使用 rx()ry() 函数返回坐标的引用(允许直接操作)。

给定一个点 p,以下陈述是等价的:

p p.setX(p.x() + 1) p += QPoint(1, 0) p.rx() p.rx() + 1

一个 QPoint 对象也可以用作矢量:加法和减法的定义与矢量相同(每个分量分别相加)。一个 QPoint 对象也可以被 intqreal 除以或乘以。

此外,QPoint 类提供了 manhattanLength() 函数,该函数提供了将 QPoint 对象解释为矢量时长度的廉价近似。最后,QPoint 对象可以进行流式传输以及比较。

另请参阅

QPointF QPolygon

init(xpos, ypos)#

参数:

使用给定的坐标(xpos, ypos)构造一个点。

构造一个空点,即坐标为 (0, 0)

reduce()#

返回类型:

对象

返回类型:

对象

点积(p1, p2)#

参数:

返回类型:

整数

警告

本部分包含从C++自动翻译为Python的代码片段,可能包含错误。

p = QPoint(3, 7) q = QPoint(-1, 4) dotProduct = QPoint.dotProduct(p, q)

dotProduct becomes 25()

返回 p1p2 的点积。

isNull()#

返回类型:

布尔

如果 x 和 y 坐标都设置为 0,则返回 true,否则返回 false

manhattanLength()#

返回类型:

整数

警告

本部分包含从C++自动翻译为Python的代码片段,可能包含错误。

返回x()y()的绝对值之和,传统上被称为从原点到点的“曼哈顿长度”。例如:

oldPosition = QPoint() MyWidget::mouseMoveEvent(QMouseEvent event) point = event.pos() - oldPosition if point.manhattanLength() > 3: # the mouse has moved more than 3 pixels since the oldPosition

这是一个有用且快速计算的真实长度的近似值:

TrueLength = std::sqrt(std::pow(x(), 2) + std::pow(y(), 2))

“曼哈顿长度”的传统产生是因为这样的距离适用于只能在矩形网格上行进的旅行者,就像曼哈顿的街道一样。

ne(p2) #

参数:

p2QPoint

返回类型:

布尔

如果 p1p2 不相等,则返回 true;否则返回 false

mul(m)#

参数:

返回类型:

QPoint

参数:

因子 – int

返回类型:

QPoint

返回给定 point 乘以给定 factor 的副本。

参数:

因子 – int

返回类型:

这是一个重载的函数。

返回给定point乘以给定factor的副本。

参数:

因子 – 浮点数

返回类型:

QPoint

返回给定point乘以给定factor的副本。

请注意,由于点被保存为整数,结果将四舍五入为最接近的整数。使用QPointF以获得浮点精度。

参数:

因子 – 浮点数

返回类型:

这是一个重载的函数。

返回给定point乘以给定factor的副本。

请注意,由于点被保存为整数,结果将四舍五入到最接近的整数。使用QPointF以获得浮点精度。

参数:

因子 – 浮点数

返回类型:

QPoint

返回给定point乘以给定factor的副本。

请注意,由于点被保存为整数,结果将四舍五入到最接近的整数。使用QPointF以获得浮点精度。

参数:

因子 – 浮点数

返回类型:

QPoint

这是一个重载的函数。

返回给定point乘以给定factor的副本。

请注意,由于点被保存为整数,结果将四舍五入到最接近的整数。使用QPointF以获得浮点精度。

参数:

矩阵QMatrix4x4

返回类型:

QPoint

参数:

矩阵QMatrix4x4

返回类型:

QPoint

注意

此函数已被弃用。

imul(factor)#

参数:

因子 – int

返回类型:

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

参数:

因子 – 浮点数

返回类型:

QPoint

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

请注意,由于点被保存为整数,结果将四舍五入为最接近的整数。使用QPointF以获得浮点精度。

参数:

因子 – 浮点数

返回类型:

QPoint

警告

本部分包含从C++自动翻译为Python的代码片段,可能包含错误。

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

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

请注意,由于点被保存为整数,结果将四舍五入为最接近的整数。使用QPointF以获得浮点精度。

add()#

返回类型:

QPoint

返回 point 不经修改。

add(p2)

参数:

p2QPoint

返回类型:

QPoint

返回一个QPoint对象,该对象是给定点p1p2的和;每个分量分别相加。

iadd(p)#

参数:

pQPoint

返回类型:

QPoint

警告

本部分包含从C++自动翻译为Python的代码片段,可能包含错误。

将给定的 point 添加到此点并返回对此点的引用。例如:

p = QPoint( 3, 7) q = QPoint( -1, 4) p += q

p becomes (2, 11)

sub()#

返回类型:

QPoint

这是一个重载的函数。

返回一个由给定point的两个分量的符号改变而形成的QPoint对象。

等同于 QPoint(0,0) - point.

参数:

p2QPoint

返回类型:

QPoint

返回一个QPoint对象,该对象由从p1中减去p2得到;每个分量分别相减。

isub(p)#

参数:

pQPoint

返回类型:

QPoint

警告

本部分包含从C++自动翻译为Python的代码片段,可能包含错误。

从此点减去给定的 point 并返回对此点的引用。例如:

p = QPoint( 3, 7) q = QPoint( -1, 4) p -= q

p becomes (4, 3)

div(c)#

参数:

c – 浮点数

返回类型:

QPoint

返回由给定point的两个分量均除以给定divisor得到的QPoint

请注意,由于点被保存为整数,结果将四舍五入到最接近的整数。使用QPointF以获得浮点精度。

operator/=(被除数)

参数:

除数 – 浮点数

返回类型:

QPoint

警告

本部分包含从C++自动翻译为Python的代码片段,可能包含错误。

这是一个重载的函数。

将 x 和 y 都除以给定的 divisor,并返回指向此点的引用。例如:

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

请注意,由于点被保存为整数,结果将四舍五入到最接近的整数。使用QPointF以获得浮点精度。

eq(p2)#

参数:

p2QPoint

返回类型:

布尔

如果 p1p2 相等,则返回 true;否则返回 false。

setX(x)#

参数:

x – 整数

将此点的 x 坐标设置为给定的 x 坐标。

setY(y)#

参数:

y – 整数

将此点的y坐标设置为给定的y坐标。

toPointF()#

返回类型:

QPointF

将此点返回为具有浮点精度的点。

toTuple()#

返回类型:

对象

transposed()#

返回类型:

返回一个x和y坐标交换的点:

QPoint{1, 2}.transposed() // {2, 1}

另请参阅

x() y() setX() setY()

x()#

返回类型:

整数

返回此点的 x 坐标。

y()

返回类型:

整数

返回此点的y坐标。

总结
QPoint类表示一个点,具有x和y坐标,可以通过x()和y()函数访问。isNull()函数在x和y均为0时返回true。可以使用setX()和setY()函数设置坐标,也可以使用rx()和ry()函数直接操作坐标。QPoint对象可用作向量,支持加减乘除操作。manhattanLength()函数返回点的曼哈顿长度。还提供了比较和流输出功能。dotProduct()计算两点的点积。__mul__()函数支持不同参数类型的乘法操作。__imul__()函数用于原地乘法。__add__()函数支持点的加法操作。