geoshape QML 值类型

A geoshape type represents an abstract geographic area. 更多...

导入语句	import QtPositioning

详细描述

This type is a QML representation of QGeoShape which is an abstract geographic area. It includes attributes and methods common to all geographic areas. To create objects that represent a valid geographic area use georectangle or geocircle.

The isValid attribute can be used to test if the geoshape represents a valid geographic area.

The isEmpty attribute can be used to test if the geoshape represents a region with a geometrical area of 0.

The contains() method can be used to test if a coordinate is within the geoshape.

示例用法

使用类型为 var 的属性来存储一个 geoshape。要创建 geoshape，使用以下任何一种方法。

要创建 geoshape 值，指定为 "shape()" 字符串

import QtPositioning

Item {
    property var region: "shape()"
}

或使用 QtPositioning.shape() 函数

import QtPositioning

Item {
    property var region: QtPositioning.shape()
}

在与 C++ 集成时请注意，从 C++ 传递到 QML 的任何 QGeoShape 值都将自动转换为 geoshape 值，反之亦然。

属性

isEmpty

bool isEmpty

返回此 geoshape 是否为空。一个空的geoshape表示一个几何面积为0的区域。

isValid

bool isValid

返回此 geoshape 是否有效。

如果一个 geoshape 必需的数据没有设置或设置为不合适的价值，则被认为是无效的。

type

ShapeType type

返回当前形状的类型。

GeoShape.UnknownType - 形状的类型是未知的。
GeoShape.RectangleType - 形状是一个 georectangle。
GeoShape.CircleType - 形状是一个 geocircle。
GeoShape.PathType - 形状是一个 geopath。 (自 Qt 5.9)
GeoShape.PolygonType - 形状是一个 geopolygon。 (自 Qt 5.10)

此 QML 属性由 Qt 5.5 引入。

方法

contains()

bool contains(coordinate coord)

如果由 coord 指定的坐标在此地理形状内，则返回 true；否则返回 false。