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（指定以米为单位的圆半径）定义的。
如果圆心坐标无效或半径小于零，则该圆被视为无效。
自 Qt 5.5 起，该类是Q_GADGET 。它可直接用于 C++ 和 QML。
属性文档
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
返回该地理圆的半径（以米为单位）。
注： 属性半径的获取函数。
另请参阅 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 ，并返回对该地理圆的引用。
© 2025 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.
