Geographic

#include <bb/platform/geo/Geographic>

To link against this class, add the following line to your .pro file: LIBS += -lbbcascadesmaps

An entity that can be placed on a map.

Subclass Contract

Subclasses must perform the following:

  • Call setBoundingBox(BoundingBox) whenever this object's bounding box changes.

  • Emit a topographyChanged signal when the contents of the Geographic have changed.

Reference Type

Geographic and it's subclasses are expected to be used as a reference type. As such, care needs to be made when referencing this object in multithreaded environments. For example, deletion in one thread can cause a dangling pointer in another thread.

Since:

BlackBerry 10.0.0

Inheritance

bb::platform::geo::Geographic
bb::platform::geo::GeoLocation

Public Functions Index

Geographic (QObject *parent=0)
Geographic (const QString &id, QObject *parent=0)
virtual ~Geographic ()
virtual bb::platform::geo::BoundingBoxboundingBox () const
QStringdescription () const
Q_SLOT voidsetDescription (const QString &desc)
QStringid () const
Q_SLOT voidsetId (const QString &id)
QStringname () const
Q_SLOT voidsetName (const QString &name)

Protected Functions Index

voidsetBoundingBox (const bb::platform::geo::BoundingBox &newBox)

Signals Index

voiddescriptionChanged (const QString &desc)
voididChanged (const QString &id)
voidnameChanged (const QString &name)
voidboundaryChanged (const bb::platform::geo::BoundingBox &box)
voidtopographyChanged (const QString &id)

Properties

QString id

The ID of this Geographic object.

Since:

BlackBerry 10.0.0

QString name

The name of this object.

Since:

BlackBerry 10.0.0

QString description

The description of this object.

Since:

BlackBerry 10.0.0

bb::platform::geo::BoundingBox boundingBox[read-only]

The axis-aligned bounding box in which this object is contained.

Since:

BlackBerry 10.0.0

Public Functions

Geographic (

Constructor.

If no ID is supplied when constructing a Geographic entity, an ID that is guaranteed to be unique will be auto-generated.
Parameters
parent

The parent of this Geographic.
Since:

BlackBerry 10.0.0

Geographic (

Constructor.

Parameters
id

The identifier for this Geographic.

parent

The parent of this Geographic.
Since:

BlackBerry 10.0.0

virtual~Geographic ()

Destructor.

virtualbb::platform::geo::BoundingBox boundingBox ()

Retrieves the axis-aligned bounding box for this Geographic.

Since:

BlackBerry 10.0.0

QString description ()

Gets the description of this Geographic.

Since:

BlackBerry 10.0.0

Q_SLOT void setDescription (

Sets the description of this Geographic.

Since:

BlackBerry 10.0.0

QString id ()

Gets the unique identifier for this Geographic.

If two Geographics are attribute-wise equal, they still need to have different IDs. The ID needs to be unique within a process.

Since:

BlackBerry 10.0.0

Q_SLOT void setId (

Sets the identity of this Geographic.

Since:

BlackBerry 10.0.0

QString name ()

Gets the name of this Geographic.

Since:

BlackBerry 10.0.0

Q_SLOT void setName (

Sets the name of this Geographic.

Since:

BlackBerry 10.0.0

Protected Functions

void setBoundingBox (

Signals

void descriptionChanged (

Emitted when the description of this Geographic changes.

Since:

BlackBerry 10.0.0

void idChanged (

Emitted when the ID of this Geographic' changes.

Since:

BlackBerry 10.0.0

void nameChanged (

Emitted when the name of this Geographic changes.

Since:

BlackBerry 10.0.0

void boundaryChanged (

Emitted by derived classes when the bounding box has changed.

See the BoundingBox documentation.

Since:

BlackBerry 10.0.0

void topographyChanged (

Emitted when the topography of this Geographic changes.

A Geographic's topography captures the location (or geographic) properties of the element.
Parameters
id

The ID of this Geographic.
Since:

BlackBerry 10.1.0