QGeoPolygon 类
QGeoPolygon 类定义了一个地理多边形。 更多...
| 头文件 | #include <QGeoPolygon> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake | QT += positioning |
| 继承 | QGeoShape |
公共函数
| QGeoPolygon() | |
| QGeoPolygon(const QList<QGeoCoordinate> &path) | |
| QGeoPolygon(const QGeoShape &other) | |
| QGeoPolygon(const QGeoPolygon &other) | |
| ~QGeoPolygon() | |
| void | addCoordinate(const QGeoCoordinate &coordinate) |
| void | addHole(const QVariant &holePath) |
| void | addHole(const QList<QGeoCoordinate> &holePath) |
| bool | containsCoordinate(const QGeoCoordinate &coordinate) const |
| QGeoCoordinate | coordinateAt(qsizetype index) const |
| const QVariantList | hole(qsizetype index) const |
| const QList<QGeoCoordinate> | holePath(qsizetype index) const |
| qsizetype | holesCount() const |
| void | insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| double | length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const |
(since QtPositioning 5.12) const QList<QGeoCoordinate> & | perimeter() const |
| void | removeCoordinate(const QGeoCoordinate &coordinate) |
| void | removeCoordinate(qsizetype index) |
| void | removeHole(qsizetype index) |
| void | replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
(since QtPositioning 5.12) void | setPerimeter(const QList<QGeoCoordinate> &path) |
| qsizetype | size() const |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoPolygon | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoPolygon & | operator=(const QGeoPolygon &other) |
详细描述
多边形通过一个有序列表的QGeoCoordinate对象定义，表示其周界。
列表中的每个相邻两个元素都意图通过通过这两个元素的最短线段相连，且该线段保持恒定的方位角。这种连接可以穿过经度方向的日期线，但不能穿过两极。
这对于计算QGeoShape::boundingGeoRectangle()返回的边界框是相关的，该边界框的顶部左角的纬度将被设置为路径点集中的最大纬度。同样，底部右角的纬度将是路径点集中的最小纬度。
成员函数文档
QGeoPolygon::QGeoPolygon()
构建一个新的空地理多边形。
QGeoPolygon::QGeoPolygon(const QList<QGeoCoordinate> &path)
从path中指定的坐标构建一个新的地理多边形。
QGeoPolygon::QGeoPolygon(const QGeoShape &other)
从other的内容构建一个新的地理多边形。
QGeoPolygon::QGeoPolygon(const QGeoPolygon &other)
从other的内容构建一个新的地理多边形。
[noexcept] QGeoPolygon::~QGeoPolygon()
销毁这个多边形。
[invokable] void QGeoPolygon::addCoordinate(const QGeoCoordinate &coordinate)
将coordinate追加到多边形中。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[invokable] void QGeoPolygon::addHole(const QVariant &holePath)
设置多边形内部的孔的holePath。孔是一个包含QList<QGeoCoordinate>的QVariant。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
void QGeoPolygon::addHole(const QList<QGeoCoordinate> &holePath)
重载方法。为多边形内部的孔设置holePath。孔是一个QList<QGeoCoordinate>。
[invokable] bool QGeoPolygon::containsCoordinate(const QGeoCoordinate &coordinate) const
如果多边形的周界包含coordinate作为其中的一个元素，则返回true。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[invokable] QGeoCoordinate QGeoPolygon::coordinateAt(qsizetype index) const
返回索引 index 处的坐标。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] const QVariantList QGeoPolygon::hole(qsizetype index) const
返回一个包含 QVariant 的 QList<QGeoCoordinate>，代表索引 index 处的洞。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
const QList<QGeoCoordinate> QGeoPolygon::holePath(qsizetype index) const
返回一个包含 QList<QGeoCoordinate> 的列表，代表索引 index 处的洞。
[可调用] qsizetype QGeoPolygon::holesCount() const
返回洞的数量。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] void QGeoPolygon::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
在指定的 index 处插入 coordinate。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] double QGeoPolygon::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
返回多边形周长的长度，单位为米，从元素 indexFrom 到元素 indexTo。这个长度是每对相邻点之间最短距离的总和。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[since QtPositioning 5.12] const QList<QGeoCoordinate> &QGeoPolygon::perimeter() const
返回多边形周长所有元素的列表。
注意：周长属性的获取函数。
此函数是在 QtPositioning 5.12 中引入的。
另请参阅：setPerimeter()。
[可调用] void QGeoPolygon::removeCoordinate(const QGeoCoordinate &coordinate)
从多边形中移除 coordinate 的最后一个出现。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] void QGeoPolygon::removeCoordinate(qsizetype index)
从多边形中移除位置 index 的元素。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] void QGeoPolygon::removeHole(qsizetype index)
从洞的列表中移除位置 index 的元素。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] void QGeoPolygon::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
将指定 index 的路径元素替换为 coordinate。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[自 QtPositioning 5.12 开始] void QGeoPolygon::setPerimeter(const QList<QGeoCoordinate> &path)
根据坐标列表 path 设置多边形的周长。
注意：属性 perimeter 的设置函数。
此函数是在 QtPositioning 5.12 中引入的。
另请参阅：perimeter()。
[可调用] qsizetype QGeoPolygon::size() const
返回多边形中的元素数量。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] QString QGeoPolygon::toString() const
将地多边形属性作为字符串返回。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] void QGeoPolygon::translate(double degreesLatitude, double degreesLongitude)
通过 degreesLatitude 向北和 degreesLongitude 向东平移此地理多边形。
degreesLatitude 和 degreesLongitude 的负值分别对应南向和平移。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
[可调用] QGeoPolygon QGeoPolygon::translated(double degreesLatitude, double degreesLongitude) const
返回一个通过 degreesLatitude 向北和 degreesLongitude 向东平移的此地理多边形的副本。
degreesLatitude 和 degreesLongitude 的负值分别对应南向和平移。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
另请参阅：translate()。
QGeoPolygon &QGeoPolygon::operator=(const QGeoPolygon &other)
将 other 分配给此地理多边形，并返回对此地理多边形的引用。
© 2024 The Qt Company Ltd. 包含在本内的文档贡献是各自所有者的版权。本提供的文档是根据自由软件开发基金会发布的 GNU自由文档许可证第1.3版 的条款许可的。Qt和相应的标志是The Qt Company Ltd在芬兰以及/或其他国家的商标。所有其他商标均为其各自所有者的财产。
