MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QGeoMappingManagerEngine Class Reference

The QGeoMappingManagerEngine class provides an interface and convenience methods to implementors of QGeoServiceProvider plugins who want to provides support for displaying and interacting with maps. More...

 #include <QGeoMappingManagerEngine>

Inherits: QObject.

Inherited by: QGeoTiledMappingManagerEngine.

This class was introduced in Qt Mobility 1.1.

Public Functions

QGeoMappingManagerEngine ( const QMap<QString, QVariant> & parameters, QObject * parent = 0 )
virtual ~QGeoMappingManagerEngine ()
virtual QGeoMapData * createMapData () = 0
QLocale locale () const
QString managerName () const
int managerVersion () const
qreal maximumTilt () const
qreal maximumZoomLevel () const
qreal minimumTilt () const
qreal minimumZoomLevel () const
void setLocale ( const QLocale & locale )
QList<QGraphicsGeoMap::ConnectivityMode> supportedConnectivityModes () const
QList<QGraphicsGeoMap::MapType> supportedMapTypes () const
bool supportsBearing () const
bool supportsCustomMapObjects () const
bool supportsTilting () const
  • 29 public functions inherited from QObject

Protected Functions

void setMaximumTilt ( qreal maximumTilt )
void setMaximumZoomLevel ( qreal maximumZoom )
void setMinimumTilt ( qreal minimumTilt )
void setMinimumZoomLevel ( qreal minimumZoom )
void setSupportedConnectivityModes ( const QList<QGraphicsGeoMap::ConnectivityMode> & connectivityModes )
void setSupportedMapTypes ( const QList<QGraphicsGeoMap::MapType> & mapTypes )
void setSupportsBearing ( bool supportsBearing )
void setSupportsCustomMapObjects ( bool supportsCustomMapObjects )
void setSupportsTilting ( bool supportsTilting )
  • 7 protected functions inherited from QObject

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 signal inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QGeoMappingManagerEngine class provides an interface and convenience methods to implementors of QGeoServiceProvider plugins who want to provides support for displaying and interacting with maps.

Subclasses of QGeoMappingManagerEngine need to provide an implementations of createMapData(). The QGeoMapData instances returned by createMapData() can be used to contain and manage information concerning what a particular QGraphicsGeoMap is viewing.

Most of the other functions configure the reported capabilities of the engine. It is important that these functions are called before createMapData() or any of the capability reporting functions are used to prevent incorrect or inconsistent behaviour.

Member Function Documentation

QGeoMappingManagerEngine::QGeoMappingManagerEngine ( const QMap<QString, QVariant> & parameters, QObject * parent = 0 )

Constructs a new engine with the specified parent, using parameters to pass any implementation specific data to the engine.

This function was introduced in Qt Mobility 1.1.

QGeoMappingManagerEngine::~QGeoMappingManagerEngine () [virtual]

Destroys this engine.

QGeoMapData * QGeoMappingManagerEngine::createMapData () [pure virtual]

Returns a new QGeoMapData instance which will be managed by this manager.

A QGeoMapData instance contains and manages the information about what a QGraphicsGeoMap is looking at. A single manager can be used by several QGraphicsGeoMap instances since each instance has an associated QGeoMapData instance.

The QGeoMapData instance can be treated as a kind of session object, or as a model in a model-view-controller architecture, with QGraphicsGeoMap as the view and QGeoMappingManagerEngine as the controller.

Subclasses of QGeoMappingManagerEngine are free to override this function to return subclasses of QGeoMapData in order to customize the map.

This function was introduced in Qt Mobility 1.1.

QLocale QGeoMappingManagerEngine::locale () const

Returns the locale used to hint to this mapping manager about what language to use for map labels.

This function was introduced in Qt Mobility 1.2.

See also setLocale().

QString QGeoMappingManagerEngine::managerName () const

Returns the name which this engine implementation uses to distinguish itself from the implementations provided by other plugins.

The combination of managerName() and managerVersion() should be unique amongst plugin implementations.

This function was introduced in Qt Mobility 1.1.

int QGeoMappingManagerEngine::managerVersion () const

Returns the version of this engine implementation.

The combination of managerName() and managerVersion() should be unique amongst plugin implementations.

This function was introduced in Qt Mobility 1.1.

qreal QGeoMappingManagerEngine::maximumTilt () const

Returns the maximum tilt supported by this engine.

Value in degrees where 0 is equivalent to 90 degrees between view and earth's surface i.e. looking straight down to earth.

This function was introduced in Qt Mobility 1.2.

See also setMaximumTilt().

qreal QGeoMappingManagerEngine::maximumZoomLevel () const

Returns the maximum zoom level supported by this engine.

Larger values of the zoom level correspond to more detailed views of the map.

This function was introduced in Qt Mobility 1.1.

See also setMaximumZoomLevel().

qreal QGeoMappingManagerEngine::minimumTilt () const

Returns the minimum tilt supported by this engine.

Value in degrees where 0 is equivalent to 90 degrees between view and earth's surface i.e. looking straight down to earth.

This function was introduced in Qt Mobility 1.2.

See also setMinimumTilt().

qreal QGeoMappingManagerEngine::minimumZoomLevel () const

Returns the minimum zoom level supported by this engine.

Larger values of the zoom level correspond to more detailed views of the map.

This function was introduced in Qt Mobility 1.1.

See also setMinimumZoomLevel().

void QGeoMappingManagerEngine::setLocale ( const QLocale & locale )

Sets the locale to be used by the this manager to locale.

If this mapping manager supports returning map labels in different languages, they will be returned in the language of locale.

The locale used defaults to the system locale if this is not set.

This function was introduced in Qt Mobility 1.2.

See also locale().

void QGeoMappingManagerEngine::setMaximumTilt ( qreal maximumTilt ) [protected]

Sets the maximum tilt supported by this engine to maximumTilt.

Value in degrees where 0 is equivalent to 90 degrees between view and earth's surface i.e. looking straight down to earth.

Subclasses of QGeoMappingManagerEngine should use this function to ensure maximumTilt() provides accurate information. If no maximum value is set by the subclass the value of 0 is used.

This function was introduced in Qt Mobility 1.2.

See also maximumTilt().

void QGeoMappingManagerEngine::setMaximumZoomLevel ( qreal maximumZoom ) [protected]

Sets the maximum zoom level supported by this engine to maximumZoom.

Larger values of the zoom level correspond to more detailed views of the map.

Subclasses of QGeoMappingManagerEngine should use this function to ensure maximumZoomLevel() provides accurate information.

This function was introduced in Qt Mobility 1.1.

See also maximumZoomLevel().

void QGeoMappingManagerEngine::setMinimumTilt ( qreal minimumTilt ) [protected]

Sets the minimum tilt supported by this engine to minimumTilt.

Value in degrees where 0 is equivalent to 90 degrees between view and earth's surface i.e. looking straight down to earth.

Subclasses of QGeoMappingManagerEngine should use this function to ensure minimumTilt() provides accurate information. If no minimum value is set by the subclass the value of 0 is used.

This function was introduced in Qt Mobility 1.2.

See also minimumTilt().

void QGeoMappingManagerEngine::setMinimumZoomLevel ( qreal minimumZoom ) [protected]

Sets the minimum zoom level supported by this engine to minimumZoom.

Larger values of the zoom level correspond to more detailed views of the map.

Subclasses of QGeoMappingManagerEngine should use this function to ensure minimumZoomLevel() provides accurate information.

This function was introduced in Qt Mobility 1.1.

See also minimumZoomLevel().

void QGeoMappingManagerEngine::setSupportedConnectivityModes ( const QList<QGraphicsGeoMap::ConnectivityMode> & connectivityModes ) [protected]

Sets the list of connectivity modes supported by this engine to connectivityModes.

Subclasses of QGeoMappingManagerEngine should use this function to ensure that supportedConnectivityModes() provides accurate information.

If createMapData does not specify a connectivity mode the first mode from connectivityModes will be used, or QGraphicsGeoMap::NoConnectivity will be used if connectivityModes is empty.

This function was introduced in Qt Mobility 1.1.

See also supportedConnectivityModes().

void QGeoMappingManagerEngine::setSupportedMapTypes ( const QList<QGraphicsGeoMap::MapType> & mapTypes ) [protected]

Sets the list of map types supported by this engine to mapTypes.

Subclasses of QGeoMappingManagerEngine should use this function to ensure that supportedMapTypes() provides accurate information.

This function was introduced in Qt Mobility 1.1.

See also supportedMapTypes().

void QGeoMappingManagerEngine::setSupportsBearing ( bool supportsBearing ) [protected]

Sets whether bearing is supported by this engine to supportsBearing.

Subclasses of QGeoMappingManagerEngine should use this function to ensure supportsBearing() provides accurate information. If no value is set by the subclass then bearing support is disabled and supportsBearing set to false.

This function was introduced in Qt Mobility 1.2.

See also supportsBearing().

void QGeoMappingManagerEngine::setSupportsCustomMapObjects ( bool supportsCustomMapObjects ) [protected]

Sets whether custom map objects are supported by this engine to supportsCustomMapObjects.

Custom map objects are map objects based on QGraphicsItem instances, which are hard to support in cases where the map rendering is not being performed by the Qt Graphics View framwork.

This function was introduced in Qt Mobility 1.2.

See also supportsCustomMapObjects().

void QGeoMappingManagerEngine::setSupportsTilting ( bool supportsTilting ) [protected]

Sets whether tilting is supported by this engine to supportsTilting.

Subclasses of QGeoMappingManagerEngine should use this function to ensure supportsTilting() provides accurate information. If no value is set by the subclass then tilting support is disabled and supportsTilting set to false.

This function was introduced in Qt Mobility 1.2.

See also supportsTilting().

QList<QGraphicsGeoMap::ConnectivityMode> QGeoMappingManagerEngine::supportedConnectivityModes () const

Returns a list of the connectivity modes supported by this engine.

This function was introduced in Qt Mobility 1.1.

See also setSupportedConnectivityModes().

QList<QGraphicsGeoMap::MapType> QGeoMappingManagerEngine::supportedMapTypes () const

Returns a list of the map types supported by this engine.

This function was introduced in Qt Mobility 1.1.

See also setSupportedMapTypes().

bool QGeoMappingManagerEngine::supportsBearing () const

Return whether bearing is supported by this engine.

This function was introduced in Qt Mobility 1.1.

See also setSupportsBearing().

bool QGeoMappingManagerEngine::supportsCustomMapObjects () const

Returns whether custom map objects are supported by this engine.

Custom map objects are map objects based on QGraphicsItem instances, which are hard to support in cases where the map rendering is not being performed by the Qt Graphics View framwork.

This function was introduced in Qt Mobility 1.2.

See also setSupportsCustomMapObjects().

bool QGeoMappingManagerEngine::supportsTilting () const

Return whether tilting is supported by this engine.

This function was introduced in Qt Mobility 1.2.

See also setSupportsTilting().