PySide6.QtPositioning.QGeoRectangle

class QGeoRectangle

QGeoRectangle 类定义了一个矩形的地理区域。更多…

PySide6.QtPositioning.QGeoRectangle 的继承图

概要

属性

  • bottomLeftᅟ - 此属性保存此地理矩形的左下角坐标

  • bottomRightᅟ - 此属性保存此地理矩形的右下角坐标

  • centerᅟ - 此属性保存此地理矩形的中心

  • heightᅟ - 此属性保存此地理矩形的高度，单位为度

  • topLeftᅟ - 此属性保存此地理矩形的左上角坐标

  • topRightᅟ - 此属性保存此地理矩形的右上角坐标

  • widthᅟ - 此属性保存此地理矩形的宽度，单位为度

方法

注意

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

详细描述

矩形是通过一个QGeoCoordinate来定义的，该坐标指定了矩形的左上角坐标，以及另一个QGeoCoordinate，该坐标指定了矩形的右下角坐标。

如果左上角或右下角坐标无效，或者左上角坐标位于右下角坐标的南边，则认为地理矩形无效。

地理矩形永远不能跨越极点。

几种方法的行为就好像地理矩形是根据中心坐标、地理矩形的宽度（以度为单位）和地理矩形的高度（以度为单位）定义的。

如果地理矩形的高度或中心被调整，使其跨越其中一个极点，则高度将被修改，以使地理矩形接触但不跨越极点，并且中心坐标仍位于地理矩形的中心。

这个类自 Qt 5.5 起是一个 Q_GADGET。它可以直接从 C++ 和 QML 使用。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property bottomLeftᅟ: QGeoCoordinate

此属性保存此地理矩形的左下角坐标。

虽然这个属性是在 Qt 5.5 中引入的，但相关的访问器函数自该类的第一个版本以来就存在。

Access functions:
property bottomRightᅟ: QGeoCoordinate

此属性保存此地理矩形的右下角坐标。

虽然这个属性是在 Qt 5.5 中引入的，但相关的访问器函数自该类的第一个版本以来就存在。

Access functions:
property centerᅟ: QGeoCoordinate

此属性保存此地理矩形的中心。

虽然这个属性是在 Qt 5.5 中引入的，但相关的访问器函数自该类的第一个版本以来就存在。

另请参阅

center

Access functions:
property heightᅟ: float

此属性保存此地理矩形的高度，单位为度。

如果此地理矩形无效，则属性值未定义。

如果新高度小于0.0或此地理矩形无效，则不会更改属性。要根据中心、宽度和高度设置无效地理矩形的值，您应首先使用setCenter()使地理矩形有效。

如果高度的变化会导致地理矩形跨越极点，则调整高度以使地理矩形仅接触极点。

进行此更改是为了使中心坐标仍然位于地理矩形的中心，这可能导致地理矩形的高度比预期的小。

180.0 是仅在新的高度大于或等于 180 时使用的高度。

虽然这个属性是在 Qt 5.5 中引入的，但相关的访问器函数自该类的第一个版本以来就存在。

Access functions:
property topLeftᅟ: QGeoCoordinate

此属性保存此地理矩形的左上角坐标。

虽然这个属性是在 Qt 5.5 中引入的，但相关的访问器函数自该类的第一个版本以来就存在。

Access functions:
property topRightᅟ: QGeoCoordinate

此属性保存此地理矩形的右上角坐标。

虽然这个属性是在 Qt 5.5 中引入的，但相关的访问器函数自该类的第一个版本以来就存在。

Access functions:
property widthᅟ: float

此属性保存此地理矩形的宽度，单位为度。

如果此地理矩形无效，则属性值未定义。

如果新宽度小于0.0或此地理矩形无效，此函数不执行任何操作。要基于中心、宽度和高度设置无效地理矩形的值，您应首先使用setCenter()使地理矩形有效。

360.0 是仅当新宽度等于或大于 360 时使用的宽度。在这种情况下，地理矩形的左侧经度设置为 -180.0 度，地理矩形的右侧经度设置为 180.0 度。

虽然这个属性是在 Qt 5.5 中引入的，但相关的访问器函数自该类的第一个版本以来就存在。

Access functions:
__init__()

构造一个新的无效的地理矩形。

__init__(other)
Parameters:

其他 – QGeoRectangle

从other的内容构造一个地理矩形。

__init__(other)
Parameters:

其他 – QGeoShape

从other的内容构造一个地理矩形。

__init__(coordinates)
Parameters:

coordinates – QGeoCoordinate 的列表

构建一个新的地理矩形，最小尺寸，包含所有的coordinates。

__init__(topLeft, bottomRight)
Parameters:

使用左上角坐标 topLeft 和右下角坐标 bottomRight 构造一个新的地理矩形。

__init__(center, degreesWidth, degreesHeight)
Parameters:

  • center – QGeoCoordinate

  • degreesWidth – 浮点数

  • degreesHeight – 浮点数

构造一个新的地理矩形，以center为中心，宽度为degreesWidth度，高度为degreesHeight度。

如果 degreesHeight 会使地理矩形超出其中一个极点，地理矩形的高度将被截断，使得地理矩形仅延伸到极点。地理矩形的中心将保持不变，高度将被调整，使得中心点位于截断后的地理矩形的中心。

bottomLeft()
Return type:

QGeoCoordinate

返回此地理矩形的左下角坐标。

另请参阅

setBottomLeft()

属性 bottomLeftᅟ 的获取器。

bottomRight()
Return type:

QGeoCoordinate

返回此地理矩形的右下角坐标。

另请参阅

setBottomRight()

属性 bottomRightᅟ 的获取器。

contains(rectangle)
Parameters:

矩形 – QGeoRectangle

Return type:

布尔

返回地理矩形 rectangle 是否包含在此地理矩形内。

extendRectangle(coordinate)
Parameters:

坐标 – QGeoCoordinate

扩展地理矩形以覆盖坐标 coordinate

height()
Return type:

浮点数

返回此地理矩形的高度（以度为单位）。

如果此地理矩形无效，则返回值为未定义。

另请参阅

setHeight()

属性 heightᅟ 的获取器。

intersects(rectangle)
Parameters:

矩形 – QGeoRectangle

Return type:

布尔

返回地理矩形 rectangle 是否与此地理矩形相交。

如果两个地理矩形的顶部或底部边缘位于极点之一，则认为地理矩形相交，因为当边缘位于极点时，经度无关紧要。

__or__(rectangle)
Parameters:

矩形 – QGeoRectangle

Return type:

QGeoRectangle

返回包含此地理矩形和rectangle的最小地理矩形。

如果两个地理矩形的中心正好相隔180.0度，则宽度设置为360.0度，最左经度设置为-180.0度，最右经度设置为180.0度。这样做是为了确保结果与操作数的顺序无关。

__ior__(rectangle)
Parameters:

矩形 – QGeoRectangle

Return type:

QGeoRectangle

返回包含此地理矩形和rectangle的最小地理矩形。

如果两个地理矩形的中心正好相隔180.0度，则宽度设置为360.0度，最左经度设置为-180.0度，最右经度设置为180.0度。这样做是为了确保结果与操作数的顺序无关。

setBottomLeft(bottomLeft)
Parameters:

bottomLeft – QGeoCoordinate

将此地理矩形的左下角坐标设置为 bottomLeft。

另请参阅

bottomLeft()

属性 bottomLeftᅟ 的设置器。

setBottomRight(bottomRight)
Parameters:

bottomRight – QGeoCoordinate

将此地理矩形的右下角坐标设置为 bottomRight。

另请参阅

bottomRight()

属性 bottomRightᅟ 的设置器。

setCenter(center)
Parameters:

中心 – QGeoCoordinate

将此地理矩形的中心设置为 center。

如果这导致地理矩形跨越极点之一，则地理矩形的高度将被截断，使得地理矩形仅延伸到极点。地理矩形的中心将保持不变，并且高度将被调整，使得中心点位于截断后的地理矩形的中心。

另请参阅

center()

属性 centerᅟ 的设置器。

setHeight(degreesHeight)
Parameters:

degreesHeight – 浮点数

将此地理矩形的高度设置为degreesHeight度。

另请参阅

height()

属性 heightᅟ 的设置器。

setTopLeft(topLeft)
Parameters:

topLeft – QGeoCoordinate

将此地理矩形的左上角坐标设置为 topLeft。

另请参阅

topLeft()

属性 topLeftᅟ 的设置器。

setTopRight(topRight)
Parameters:

topRight – QGeoCoordinate

将此地理矩形的右上角坐标设置为 topRight。

另请参阅

topRight()

属性 topRightᅟ 的设置器。

setWidth(degreesWidth)
Parameters:

degreesWidth – 浮点数

将此地理矩形的宽度设置为degreesWidth度。

另请参阅

width()

属性 widthᅟ 的设置器。

topLeft()
Return type:

QGeoCoordinate

返回此地理矩形的左上角坐标。

另请参阅

setTopLeft()

属性 topLeftᅟ 的获取器。

topRight()
Return type:

QGeoCoordinate

返回此地理矩形的右上角坐标。

另请参阅

setTopRight()

属性 topRightᅟ 的获取器。

translate(degreesLatitude, degreesLongitude)
Parameters:

  • degreesLatitude – 浮点数

  • degreesLongitude – 浮点数

将这个地理矩形向北移动 degreesLatitude 度，向东移动 degreesLongitude 度。

degreesLatitude 和 degreesLongitude 的负值分别对应于向南和向西的平移。

如果平移会导致地理矩形跨越极点，地理矩形将被平移，直到地理矩形的顶部或底部边缘接触到极点，但不会进一步平移。

translated(degreesLatitude, degreesLongitude)
Parameters:

  • degreesLatitude – 浮点数

  • degreesLongitude – 浮点数

Return type:

QGeoRectangle

返回此地理矩形的一个副本，该副本向北方平移了degreesLatitude度，向东方平移了degreesLongitude度。

degreesLatitude 和 degreesLongitude 的负值分别对应于向南和向西的平移。

另请参阅

translate()

united(rectangle)
Parameters:

矩形 – QGeoRectangle

Return type:

QGeoRectangle

返回包含此地理矩形和rectangle的最小地理矩形。

如果两个地理矩形的中心正好相隔180.0度，则宽度设置为360.0度，最左经度设置为-180.0度，最右经度设置为180.0度。这样做是为了确保结果与操作数的顺序无关。

width()
Return type:

浮点数

返回此地理矩形的宽度（以度为单位）。

如果此地理矩形无效，则返回值为未定义。

另请参阅

setWidth()

属性 widthᅟ 的获取器。