class QGeoRectangle

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

概述

属性

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

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

• center属性 - 该属性保持此地理矩形中心的坐标

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

• topLeft - 此属性包含此地理矩形的左上角坐标

• topRight - 此属性包含此地理矩形的右上角坐标

• width - 此属性包含此地理矩形的宽度（以度为单位

方法

• def __init__()

• def bottomLeft()

• def bottomRight()

• def contains()

• def extendRectangle()

• def height()

• def intersects()

• def __or__()

• def __ior__()

• def setBottomLeft()

• def setBottomRight()

• def setCenter()

• def setHeight()

• def setTopLeft()

• def setTopRight()

• def setWidth()

• def topLeft()

• def topRight()

• def translate()

• 定义 translated()

• 定义 united()

• 定义 width()

注意：

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

详细描述

矩形以一个 QGeoCoordinate 定义，指定矩形的左上角坐标，以及一个 QGeoCoordinate，指定矩形的右下角坐标。

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

地理矩形永远不会跨越两极。

一些方法的行为好像地理矩形是以中心坐标、地理矩形在度数中的宽度和高度定义的。

如果一个地理矩形的宽度或中心被调整到会穿过极点，则将宽度修改为使地理矩形接触但不穿越极点，并且中心坐标仍然位于地理矩形的中心。

自Qt 5.5以来，此类为Q_GADGET。它可以 直接从C++和QML中使用。

注意：

可以使用属性或其他方式通过访问器函数直接使用时，请使用from __feature__ import true_property。

属性 bottomLeftᅟ: QGeoCoordinate

此属性包含此地理矩形的左下角坐标。

虽然此属性是在Qt 5.5中引入的，但相关的访问器函数存在于此类第一版。

访问函数：

• bottomLeft()

• setBottomLeft()

属性 bottomRightᅟ: QGeoCoordinate

此属性包含此地理矩形的右下角坐标。

虽然此属性是在Qt 5.5中引入的，但相关的访问器函数存在于此类第一版。

访问函数：

• bottomRight()

• setBottomRight()

属性 centerᅟ: QGeoCoordinate

此属性包含此地理矩形的中心。

虽然此属性是在Qt 5.5中引入的，但相关的访问器函数存在于此类第一版。

另请参阅：

center

访问函数：

• setCenter()

属性 高度: 浮点数

此属性包含此地理矩形的…

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

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

如果高度的变化会导致地理矩形穿过北极点，则高度会相应调整，使得地理矩形仅接触北极点。

此更改是为了确保中心坐标仍然位于地理矩形的中心，这可能会导致地理矩形的实际高度小于预期。

如果新的高度大于或等于 180，则只使用 180.0 作为高度。

虽然此属性是在Qt 5.5中引入的，但相关的访问器函数存在于此类第一版。

访问函数：

• height()

• setHeight()

属性 左上角: QGeoCoordinate

此属性包含此地理矩形的…

虽然此属性是在Qt 5.5中引入的，但相关的访问器函数存在于此类第一版。

访问函数：

• topLeft()

• setTopLeft()

属性 右上角: QGeoCoordinate

此属性包含此地理矩形的…

虽然此属性是在Qt 5.5中引入的，但相关的访问器函数存在于此类第一版。

访问函数：

• topRight()

• setTopRight()

属性 宽度: 浮点数

此属性包含此地理矩形的…

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

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

如果新的宽度等于或大于 360，则仅使用 360.0 作为宽度。在这种情况下，地理矩形的左最长远度设置为 -180.0 度，而最右长远度设置为 180.0 度。

虽然此属性是在Qt 5.5中引入的，但相关的访问器函数存在于此类第一版。

访问函数：

• width()

• setWidth()

__init__(center, degreesWidth, degreesHeight)

参数：

• center – QGeoCoordinate

• degreesWidth – 浮点数

• degreesHeight – 浮点数

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

如果 degreesHeight 将地形矩形延伸到极点之外，则地形矩形的高度将被截断，如此地形矩形仅延伸到极点。地形矩形的中心将保持不变，高度将调整，使得中心点位于截断的地形矩形的中心。

__init__(topLeft, bottomRight)

参数：

• topLeft – QGeoCoordinate

• bottomRight – QGeoCoordinate

构建一个以 topLeft 为右上角坐标，bottomRight 为左下角坐标的地形矩形。

__init__(other)

参数：

other – QGeoRectangle

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

__init__(other)

参数：

other – QGeoShape

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

__init__(coordinates)

参数：

coordinates – QGeoCoordinate 的列表

构建一个包含所有 coordinates 的最小编码地形矩形。

__init__()

构建一个无效的地形矩形。

bottomLeft()

返回类型：

QGeoCoordinate

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

另请参阅：

setBottomLeft()

属性 bottomLeft 的获取器。

bottomRight()

返回类型：

QGeoCoordinate

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

另请参阅：

setBottomRight()

属性 bottomRight 的获取器。

contains(rectangle)

参数：

矩形 – QGeoRectangle

返回类型：

bool

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

extendRectangle(coordinate)

参数：

coordinate – QGeoCoordinate

将geo矩形扩展到也包含坐标coordinate

height()

返回类型：

float

以度为单位返回此geo矩形的高度。

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

另请参阅：

setHeight()

属性height的获取器。

intersects(rectangle)

参数：

矩形 – QGeoRectangle

返回类型：

bool

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

如果两个geo矩形的上下边缘位于其中一个极点，则认为它们相交，因为在边缘位于极点时经度是无关紧要的。

__or__(rectangle)

参数：

矩形 – QGeoRectangle

返回类型：

QGeoRectangle

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

如果两个geo矩形的中心相隔正好是180.0度，则宽度设置为360.0度，最左侧经度设置为-180.0度，最右侧经度设置为180.0度。这样做是为了确保结果不依赖于操作数的顺序。

__ior__(rectangle)

参数：

矩形 – QGeoRectangle

返回类型：

QGeoRectangle

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

如果两个geo矩形的中心相隔正好是180.0度，则宽度设置为360.0度，最左侧经度设置为-180.0度，最右侧经度设置为180.0度。这样做是为了确保结果不依赖于操作数的顺序。

setBottomLeft(bottomLeft)

参数：

bottomLeft – QGeoCoordinate

将此geo矩形的左下坐标设置为bottomLeft。

另请参阅：

bottomLeft()

属性bottomLeft的设置器。

setBottomRight(bottomRight)

参数：

bottomRight – QGeoCoordinate

将此geo矩形的右下坐标设置为bottomRight。

另请参阅：

bottomRight()

属性 bottomRightᅟ 的设置器。

setCenter(center)

参数：

center – QGeoCoordinate

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

如果这导致地理矩形跨越南极或北极，地理矩形的宽度将被截断，以使地理矩形仅扩展到极点。地理矩形的中心将保持不变，而高度将调整，使得中心点位于截断后的地理矩形的中心。

另请参阅：

center()

属性 centerᅟ 的设置器。

setHeight(degreesHeight)

参数：

degreesHeight – 浮点数

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

另请参阅：

height()

属性 heightᅟ 的设置器。

setTopLeft(topLeft)

参数：

topLeft – QGeoCoordinate

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

另请参阅：

topLeft()

属性 topLeftᅟ 的设置器。

setTopRight(topRight)

参数：

topRight – QGeoCoordinate

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

另请参阅：

topRight()

属性 topRightᅟ 的设置器。

setWidth(degreesWidth)

参数：

degreesWidth – 浮点数

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

另请参阅：

width()

属性 widthᅟ 的设置器。

topLeft()

返回类型：

QGeoCoordinate

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

另请参阅：

setTopLeft()

属性 topLeftᅟ 的获取器。

topRight()

返回类型：

QGeoCoordinate

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

另请参阅：

setTopRight()

属性 topRightᅟ 的获取器。

translate(degreesLatitude, degreesLongitude)

参数：

• degreesLatitude – float

• degreesLongitude – float

将此地理矩形沿 degreesLatitude 向北和 degreesLongitude 向东平移。

负值 degreesLatitude 和 degreesLongitude 分别表示向南和向西平移。

如果平移会导致地理矩形越过极点，则地理矩形将被平移，直到地理矩形的上边或下边触及极点，但不会进一步平移。

translated(degreesLatitude, degreesLongitude)

参数：

• degreesLatitude – float

• degreesLongitude – float

返回类型：

QGeoRectangle

返回一个副本，将此地理矩形沿 degreesLatitude 向北和 degreesLongitude 向东平移。

负值 degreesLatitude 和 degreesLongitude 分别表示向南和向西平移。

另请参阅：

translate()

united(rectangle)

参数：

矩形 – QGeoRectangle

返回类型：

QGeoRectangle

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

如果两个geo矩形的中心相隔正好是180.0度，则宽度设置为360.0度，最左侧经度设置为-180.0度，最右侧经度设置为180.0度。这样做是为了确保结果不依赖于操作数的顺序。

width()

返回类型：

float

返回本地理矩形在度单位的宽度。

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

另请参阅：

setWidth()

属性 widthᅟ 的获取器。