geoShape QML Value Type

A geoShape type represents an abstract geographic area. More...

Import Statement: import QtPositioning

Properties

Methods

Detailed Description

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 shape represents a valid geographic area.

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

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

Example Usage

To create a geoShape value, use the QtPositioning.shape() function:

import QtPositioning

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

When integrating with C++, note that any QGeoShape value passed into QML from C++ is automatically converted into a geoShape value, and vice-versa.

Property Documentation

isEmpty : bool

Returns whether this shape is empty. An empty shape is a region which has a geometrical area of 0.


isValid : bool

Returns whether this shape is valid.

A shape is considered to be invalid if some of the data that is required to unambiguously describe the shape has not been set or has been set to an unsuitable value.


type : ShapeType

Returns the current type of the shape.

  • GeoShape.UnknownType - The shape's type is not known.
  • GeoShape.RectangleType - The shape is a geoRectangle.
  • GeoShape.CircleType - The shape is a geoCircle.
  • GeoShape.PathType - The shape is a geoPath. (Since Qt 5.9)
  • GeoShape.PolygonType - The shape is a geoPolygon. (Since Qt 5.10)

This QML property was introduced by Qt 5.5.


Method Documentation

bool contains(geoCoordinate coord)

Returns true if the coordinate specified by coord is within this shape; otherwise returns false.


© 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.