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.
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 |
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 ) |
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.
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.
Destroys this engine.
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.
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().
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.
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.
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().
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().
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().
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().
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().
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().
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().
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().
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().
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().
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().
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().
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().
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().
Returns a list of the connectivity modes supported by this engine.
This function was introduced in Qt Mobility 1.1.
See also setSupportedConnectivityModes().
Returns a list of the map types supported by this engine.
This function was introduced in Qt Mobility 1.1.
See also setSupportedMapTypes().
Return whether bearing is supported by this engine.
This function was introduced in Qt Mobility 1.1.
See also setSupportsBearing().
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().
Return whether tilting is supported by this engine.
This function was introduced in Qt Mobility 1.2.
See also setSupportsTilting().
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.