class QPoint#

QPoint 类使用整数精度定义平面上的一点。 更多信息…

概述#

方法#

静态函数#

注意

本文档可能包含自动将 C++ 翻译为 Python 的代码片段。我们始终欢迎使用贡献来翻译片段。如果您发现翻译有问题，也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 上创建工单来通知我们。

详细描述#

警告

本节包含自动从 C++ 翻译到 Python 的代码片段，可能存在错误。

一个点由 x 坐标和 y 坐标指定，可以通过 x()} 和 y() 函数访问。如果 x 和 y 都设置为 0，则 isNull() 函数返回 true。可以使用 setX() 和 setY() 函数设置（或更改）坐标，或者也可以使用返回坐标引用的 rx() 和 ry() 函数（允许直接操作）。

给定一个点 p，以下语句都是等价的

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

一个QPoint对象也可以用作一个矢量：加法和减法被定义为矢量（各分量分别相加）。一个QPoint对象还可以除以或乘以一个int或一个qreal。

此外，QPoint类提供了manhattanLength()函数，它给出了将QPoint对象解释为矢量的长度的低费用近似值。最后，QPoint对象可以转换为流也可以进行比较。

另请参阅

QPointF QPolygon

__init__(xpos, ypos)#
参数:

  • xpos – int

  • ypos – int

使用给定的坐标（xpos，ypos）构建一个点。

另请参阅

setX() setY()

__init__()

构建一个空点，即坐标为（0，0）的点。

另请参阅

isNull()

__reduce__()#
返回类型:

object

__repr__()#
返回类型:

object

静态 dotProduct(p1, p2)#
参数:
返回类型:

int

警告

本节包含自动从 C++ 翻译到 Python 的代码片段，可能存在错误。

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

返回p1和p2的点积。

isNull()#
返回类型:

bool

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

manhattanLength()#
返回类型:

int

警告

本节包含自动从 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)#
参数:

p2 – QPoint

返回类型:

bool

如果 p1 和 p2 不相等，则返回 true；否则返回 false。

__mul__(m)#
参数:

m – QTransform

返回类型:

Q点

__mul__(factor)
参数:

factor – int

返回类型:

Q点

返回给定 point 的副本，并将其乘以给定的 factor。

另请参阅

operator*=()

__mul__(factor)
参数:

factor – int

返回类型:

Q点

这是重载的函数。

返回给定 point 的副本，并将其乘以给定的 factor。

另请参阅

operator*=()

__mul__(factor)
参数:

factor – float

返回类型:

Q点

返回给定 point 的副本，并将其乘以给定的 factor。

请注意，结果是四舍五入到最接近的整数，因为点是作为整数存储的。使用 QPointF 以获得浮点精度。

另请参阅

operator*=()

__mul__(factor)
参数:

factor – float

返回类型:

Q点

这是重载的函数。

返回给定 point 的副本，并将其乘以给定的 factor。

请注意，结果是四舍五入到最接近的整数，因为点是作为整数存储的。使用 QPointF 以获得浮点精度。

另请参阅

operator*=()

__mul__(factor)
参数:

factor – float

返回类型:

Q点

返回给定 point 的副本，并将其乘以给定的 factor。

请注意，结果是四舍五入到最接近的整数，因为点是作为整数存储的。使用 QPointF 以获得浮点精度。

另请参阅

operator*=()

__mul__(factor)
参数:

factor – float

返回类型:

Q点

这是重载的函数。

返回给定 point 的副本，并将其乘以给定的 factor。

请注意，结果是四舍五入到最接近的整数，因为点是作为整数存储的。使用 QPointF 以获得浮点精度。

另请参阅

operator*=()

__mul__(matrix)
参数:

matrix – QMatrix4x4

返回类型:

Q点

__mul__(matrix)
参数:

matrix – QMatrix4x4

返回类型:

Q点

注意

此函数已弃用。

__imul__(factor)#
参数:

factor – int

返回类型:

Q点

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

另请参阅

operator/=()

__imul__(factor)
参数:

factor – float

返回类型:

Q点

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

请注意，结果是四舍五入到最接近的整数，因为点是作为整数存储的。使用 QPointF 以获得浮点精度。

另请参阅

operator/=()

__imul__(factor)
参数:

factor – float

返回类型:

Q点

警告

本节包含自动从 C++ 翻译到 Python 的代码片段，可能存在错误。

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

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

请注意，结果是四舍五入到最接近的整数，因为点是作为整数存储的。使用 QPointF 以获得浮点精度。

另请参阅

operator/=()

__add__()#
返回类型:

Q点

不修改地返回 point。

__add__(p2)
参数:

p2 – QPoint

返回类型:

Q点

返回一个表示给定点 p1 和 p2 之和的 QPoint 对象；每个分量分别相加。

另请参阅

operator+=()

__iadd__(p)#
参数:

p – QPoint

返回类型:

Q点

警告

本节包含自动从 C++ 翻译到 Python 的代码片段，可能存在错误。

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

p = QPoint( 3, 7)
q = QPoint(-1, 4)
p += q # p becomes (2, 11)

另请参阅

operator-=()

__sub__()#
返回类型:

Q点

这是重载的函数。

返回一个由给定 point 的两个分量都取反得到的 QPoint 对象。

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

__sub__(p2)
参数:

p2 – QPoint

返回类型:

Q点

返回一个从 QPoint p1 中减去 p2 得到的 QPoint 对象；每个分量分别相减。

另请参阅

operator-=()

__isub__(p)#
参数:

p – QPoint

返回类型:

Q点

警告

本节包含自动从 C++ 翻译到 Python 的代码片段，可能存在错误。

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

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

另请参阅

operator+=()

__div__(c)#
参数:

c – float

返回类型:

Q点

返回由给定 point 的两个分量除以给定的 divisor 形成的 QPoint。

请注意，结果是四舍五入到最接近的整数，因为点是作为整数存储的。使用 QPointF 以获得浮点精度。

另请参阅

operator/=()

operator/=(divisor)
参数:

divisor – float

返回类型:

Q点

警告

本节包含自动从 C++ 翻译到 Python 的代码片段，可能存在错误。

这是重载的函数。

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

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

请注意，结果是四舍五入到最接近的整数，因为点是作为整数存储的。使用 QPointF 以获得浮点精度。

另请参阅

operator*=()

__eq__(p2)#
参数:

p2 – QPoint

返回类型:

bool

如果 p1 和 p2 相等，则返回 true；否则返回 false。

setX(x)#
参数:

x – int

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

另请参阅

x() setY()

setY(y)#
参数:

y – int

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

另请参阅

y() setX()

toPointF()#
返回类型:

Q点浮点数

返回一个具有浮点精度点的此点。

另请参阅

toPoint()

toTuple()#
返回类型:

object

transposed()#
返回类型:

Q点

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

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

另请参阅

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

x()#
返回类型:

int

返回此点的x坐标。

另请参阅

setX() rx()

y()#
返回类型:

int

返回此点的y坐标。

另请参阅

setY() ry()