MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QML MapCircle Element

The MapCircle element displays a circle on a map. More...

This element was introduced in Mobility 1.2.

Properties

Detailed Description

The circle is specified in terms of a central coordinate and a radius in metres.

If center and radius are not specified and valid the circle will not be displayed.

An example, a MapCircle positioned at your current position (assuming there is a PositionSource):

 MapCircle {
     id: myPositionMarker
     center: myPositionSource.position.coordinate
     radius: 100
     color: "yellow"
 }

The element is used with a Map element.

The MapCircle element is part of the QtMobility.location 1.2 module.

Property Documentation

border.width : int

border.color : color

These properties hold the width and color used to draw the border of the circle.

The width is in pixels and is independent of the zoom level of the map.

The default values correspond to a black border with a width of 1 pixel.

For no line, use a width of 0 or a transparent color.

This property group was introduced in Mobility 1.2.


center : Coordinate

This property holds the coordinate at the center of the circle.

The default value is an invalid coordinate.

This property group was introduced in Mobility 1.2.


color : color

This property holds the color used to fill the circle.

The default value corresponds to a transparent color.

This property group was introduced in Mobility 1.2.


radius : qreal

This property holds the radius of the circle in metres.

A negative value is used to indicate that the radius is invalid and the default value is a radius of -1.0.

This property group was introduced in Mobility 1.2.


visible : bool

This property holds a boolean corresponding to whether or not the circle is visible.

This property group was introduced in Mobility 1.2.


z : int

This property holds the z-value of the circle.

Map objects are drawn in z-value order, and objects with the same z-value will be drawn in insertion order.

This property group was introduced in Mobility 1.2.