QGeoShape类

QGeoShape类定义了一个地理区域。 更多...

头文件 #include <QGeoShape>
CMakefind_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmakeQT += positioning
继承自

QGeoCircle、QGeoPath、QGeoPolygon和QGeoRectangle

公共类型

枚举ShapeType { UnknownType, RectangleType, CircleType, PathType, PolygonType }

属性

公共函数

QGeoShape()
QGeoShape(const QGeoShape &other)
~QGeoShape()
QGeoRectangleboundingGeoRectangle() const
QGeoCoordinatecenter() const
boolcontains(const QGeoCoordinate &coordinate) const
boolisEmpty() const
boolisValid() const
QStringtoString() const
QGeoShape::ShapeTypetype() const
QGeoShape &operator=(const QGeoShape &other)
size_tqHash(const QGeoShape &shape, size_t seed = 0)
booloperator!=(const QGeoShape &lhs, const QGeoShape &rhs)
booloperator==(const QGeoShape &lhs, const QGeoShape &rhs)

详细描述

此类是指定地理区域的类的基类。

为了保持一致性，子类应使用QGeoCoordinate实例以及以米为单位的距离来描述相关区域的特定细节。

自Qt 5.5起，此类为Q_GADGET。它可以从C++和QML直接使用。（更多信息）

成员类型文档

enum QGeoShape::ShapeType

描述形状的类型。

常量值描述
QGeoShape::UnknownType0未知类型的形状
QGeoShape::RectangleType1矩形形状
QGeoShape::CircleType2圆形形状
QGeoShape::PathType3路径类型
QGeoShape::PolygonType4多边形类型

属性文档

[只读] isEmpty : const bool

此属性定义了此地理形状是否为空。

空地理形状是一个几何面积为0的区域。

尽管此属性自Qt 5.5版开始引入，但相关访问器函数自该类的第一个版本就一直存在。

访问函数

boolisEmpty() const

[只读] isValid : const bool

此属性保存地理形状的有效性。

如果未设置某些用于明确描述地理形状的数据，或根据此类对象的子类已设定不当值，则认为地理形状无效。此类型默认构造的对象是无效的。

尽管此属性自Qt 5.5版开始引入，但相关访问器函数自该类的第一个版本就一直存在。

访问函数

boolisValid() const

[只读] type : const ShapeType

此属性保存此地理形状的类型。

尽管此属性自Qt 5.5版开始引入，但相关访问器函数自该类的第一个版本就一直存在。

访问函数

QGeoShape::ShapeTypetype() const

成员函数文档

QGeoShape::QGeoShape()

构建一个新的无效地理形状，类型为UnknownType。

[不可抛异常] QGeoShape::QGeoShape(const QGeoShape &other)

构建一个新的地理形状，其是other的一个副本。

注意：此函数可以通过元对象系统从QML调用。请参见Q_INVOKABLE。

[不可抛异常] QGeoShape::~QGeoShape()

销毁此地理形状。

[可调用] QGeoRectangle QGeoShape::boundingGeoRectangle() const

返回一个表示地理形状地理边界矩形的QGeoRectangle，该矩形定义了地理形状的纬度/经度边界。

注意：此函数可以通过元对象系统从QML调用。请参见Q_INVOKABLE。

QGeoCoordinate QGeoShape::center() const

返回位于地理形状几何中心的位置坐标。

注意：这是属性“center”的获取函数。

[可调用] bool QGeoShape::contains(const QGeoCoordinate &coordinate) const

返回坐标coordinate是否包含在此地理形状中。

注意：此函数可以通过元对象系统从QML调用。请参见Q_INVOKABLE。

bool QGeoShape::isEmpty() const

返回此地理形状是否为空。

空地理形状是一个几何面积为0的区域。

注意：这是属性isEmpty的获取函数。

bool QGeoShape::isValid() const

返回此地理形状是否有效。

注意：这是属性isValid的获取函数。

[可调用] QString QGeoShape::toString() const

返回该地理形状的字符串表示。

注意：此函数可以通过元对象系统从QML调用。请参见Q_INVOKABLE。

QGeoShape::ShapeType QGeoShape::type() const

返回该地理形状的类型。

注意：属性类型的获取函数。

QGeoShape &QGeoShape::operator=(const QGeoShape &other)

将other分配给该地理形状并返回对该地理形状的引用。

相关非成员项

[noexcept] size_t qHash(const QGeoShape &shape, size_t seed = 0)

返回shape的哈希值，使用seed进行计算。

bool operator!=(const QGeoShape &lhs, const QGeoShape &rhs)

如果lhs地理形状与rhs地理形状不等价，则返回true，否则返回false。

bool operator==(const QGeoShape &lhs, const QGeoShape &rhs)

如果lhs地理形状与rhs地理形状等价，则返回true，否则返回false。

© 2024 The Qt Company Ltd. 本文档中的贡献版权属于各自的所有者。本文档受GNU自由文档许可版本1.3的条款许可，由自由软件基金会发布。Qt及其相关标志是The Qt Company Ltd.在芬兰和其他国家/地区的商标。所有其他商标均为各自所有者的财产。