QGeoCircle Class
QGeoCircle 类定义了一个圆形的地理区域。更多内容...
| 头文件： | #include <QGeoCircle> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| 继承自： | QGeoShape |
属性
公共函数
| QGeoCircle() | |
| QGeoCircle(const QGeoShape &other) | |
| QGeoCircle(const QGeoCoordinate ¢er, qreal radius = -1.0) | |
| QGeoCircle(const QGeoCircle &other) | |
| ~QGeoCircle() | |
| QGeoCoordinate | center() const |
| void | extendCircle(const QGeoCoordinate &coordinate) |
| qreal | radius() const |
| void | setCenter(const QGeoCoordinate ¢er) |
| void | setRadius(qreal radius) |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoCircle | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoCircle & | operator=(const QGeoCircle &other) |
详细说明
该圆通过一个QGeoCoordinate 参数（指定圆的圆心）和一个 qreal 参数（指定圆的半径，单位为米）来定义。
如果圆心坐标无效，或者半径小于零，则该圆被视为无效。
在 QML 中，该类也可通过geoCircle 访问。
属性文档
center : QGeoCoordinate
该属性存储了地理圆的中心坐标。
如果该属性包含无效坐标，则该圆将被视为无效。
默认构造的 `QGeoCircle ` 会将一个无效的 `QGeoCoordinate ` 作为中心。
虽然该属性在 Qt 5.5 中引入，但相关的访问器函数自该类的第一个版本起便已存在。
访问函数：
radius : qreal
该属性存储圆的半径（单位：米）。
如果该属性值为负数，则该圆被视为无效。
默认情况下，半径的初始化值为-1 。
虽然该属性是在 Qt 5.5 中引入的，但相关的访问器函数自该类的第一个版本起便已存在。
访问函数：
成员函数文档
QGeoCircle::QGeoCircle()
构建一个新的、无效的几何圆。
QGeoCircle::QGeoCircle(const QGeoShape &other)
根据other 中的内容构建一个新的几何圆。
QGeoCircle::QGeoCircle(const QGeoCoordinate ¢er, qreal radius = -1.0)
构建一个以center 为中心、半径为radius 米的新几何圆。
QGeoCircle::QGeoCircle(const QGeoCircle &other)
根据other 的内容构建一个新的几何圆。
[noexcept] QGeoCircle::~QGeoCircle()
销毁该几何圆。
QGeoCoordinate QGeoCircle::center() const
返回该地理圆的中心坐标。等同于QGeoShape::center()。
注意： 这是 center 属性的获取 函数。
另请参阅 setCenter()。
[invokable] void QGeoCircle::extendCircle(const QGeoCoordinate &coordinate)
将地理圆扩展以同时覆盖该坐标coordinate
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
qreal QGeoCircle::radius() const
返回该地理圆的半径（单位：米）。
注意： 这是 radius 属性的获取 函数。
另请参阅 setRadius()。
void QGeoCircle::setCenter(const QGeoCoordinate ¢er)
将此几何圆的中心坐标设置为center 。
注意： 这是属性center 的设置 函数。
另请参阅 center()。
void QGeoCircle::setRadius(qreal radius)
将此地理圆的半径（单位：米）设置为radius 。
注意： 这是属性radius 的设置 函数。
另请参阅 radius()。
[invokable] QString QGeoCircle::toString() const
返回地理圆的属性，形式为字符串。
注意： 可通过元对象系统和 QML 调用此 函数。请参阅Q_INVOKABLE 。
[invokable] void QGeoCircle::translate(double degreesLatitude, double degreesLongitude)
将该地理圆沿degreesLatitude 向北平移，并沿degreesLongitude 向东平移。
degreesLatitude 和degreesLongitude 的负值分别对应向南和向西的平移。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
[invokable] QGeoCircle QGeoCircle::translated(double degreesLatitude, double degreesLongitude) const
返回该地理圆的副本，该副本沿degreesLatitude 向北平移，并沿degreesLongitude 向东平移。
degreesLatitude 和degreesLongitude 的负值分别对应向南和向西的平移。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 translate()。
QGeoCircle &QGeoCircle::operator=(const QGeoCircle &other)
将other 分配给此地理圆，并返回对此地理圆的引用。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
