PySide6.QtCore.QPoint

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() += 1

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

此外，QPoint 类提供了 manhattanLength() 函数，该函数提供了一个廉价的近似值，用于计算被解释为向量的 QPoint 对象的长度。最后，QPoint 对象可以被流式传输以及进行比较。

另请参阅

QPointF QPolygon

__init__()

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

另请参阅

isNull()

__init__(xpos, ypos)
Parameters:

  • xpos – 整数

  • ypos – int

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

另请参阅

setX() setY()

__reduce__()
Return type:

字符串

__repr__()
Return type:

字符串

static dotProduct(p1, p2)
Parameters:
Return type:

整数

警告

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

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

返回 p1 和 p2 的点积。

isNull()
Return type:

布尔

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

manhattanLength()
Return type:

整数

警告

本节包含从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__(rhs)
Parameters:

rhs – QPoint

Return type:

布尔

如果 lhs 和 rhs 不相等，则返回 true；否则返回 false。

__ne__(rhs)
Parameters:

rhs – QPointF

Return type:

布尔

__mul__(matrix)
Parameters:

矩阵 – QMatrix4x4

Return type:

QPoint

注意

此函数已弃用。

__mul__(matrix)
Parameters:

矩阵 – QMatrix4x4

Return type:

QPoint

__mul__(m)
Parameters:

m – QTransform

Return type:

QPoint

__mul__(factor)
Parameters:

factor – 浮点数

Return type:

QPoint

这是一个重载函数。

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

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

另请参阅

operator*=()

__mul__(factor)
Parameters:

factor – 浮点数

Return type:

QPoint

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

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

另请参阅

operator*=()

__mul__(factor)
Parameters:

factor – 浮点数

Return type:

QPoint

这是一个重载函数。

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

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

另请参阅

operator*=()

__mul__(factor)
Parameters:

factor – 浮点数

Return type:

QPoint

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

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

另请参阅

operator*=()

__mul__(factor)
Parameters:

factor – int

Return type:

QPoint

这是一个重载函数。

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

另请参阅

operator*=()

__mul__(factor)
Parameters:

factor – int

Return type:

QPoint

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

另请参阅

operator*=()

__imul__(factor)
Parameters:

factor – 浮点数

Return type:

QPoint

警告

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

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

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

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

另请参阅

operator/=()

__imul__(factor)
Parameters:

factor – 浮点数

Return type:

QPoint

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

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

另请参阅

operator/=()

__imul__(factor)
Parameters:

factor – int

Return type:

QPoint

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

另请参阅

operator/=()

__add__()
Return type:

QPoint

返回未修改的point。

__add__(p2)
Parameters:

p2 – QPoint

Return type:

QPoint

返回一个QPoint对象，该对象是给定点p1和p2的和；每个分量分别相加。

另请参阅

operator+=()

__iadd__(p)
Parameters:

p – QPoint

Return type:

QPoint

警告

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

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

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

另请参阅

operator-=()

__sub__()
Return type:

QPoint

这是一个重载函数。

返回一个QPoint对象，该对象是通过改变给定point的两个分量的符号形成的。

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

__sub__(p2)
Parameters:

p2 – QPoint

Return type:

QPoint

返回一个QPoint对象，该对象是通过从p1中减去p2形成的；每个分量分别相减。

另请参阅

operator-=()

__isub__(p)
Parameters:

p – QPoint

Return type:

QPoint

警告

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

从这个点中减去给定的point并返回这个点的引用。例如：

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

另请参阅

operator+=()

__div__(c)
Parameters:

c – 浮点数

Return type:

QPoint

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

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

另请参阅

operator/=()

operator/=(divisor)
Parameters:

除数 – float

Return type:

QPoint

警告

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

这是一个重载函数。

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

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

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

另请参阅

operator*=()

__eq__(rhs)
Parameters:

rhs – QPoint

Return type:

布尔

如果 lhs 和 rhs 相等，则返回 true；否则返回 false。

__eq__(rhs)
Parameters:

rhs – QPointF

Return type:

布尔

setX(x)
Parameters:

x – 整数

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

另请参阅

x() setY()

setY(y)
Parameters:

y – 整数

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

另请参阅

y() setX()

toPointF()
Return type:

QPointF

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

另请参阅

toPoint()

toTuple()
Return type:

对象

transposed()
Return type:

QPoint

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

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

另请参阅

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

x()
Return type:

整数

返回此点的x坐标。

另请参阅

setX() rx()

y()
Return type:

整数

返回此点的 y 坐标。

另请参阅

setY() ry()