QtMobility Reference Documentation

QGeoTiledMappingManagerEngine Class Reference

The QGeoTiledMappingManagerEngine class is provided to make writing Qt Maps and Navigation API plugins for tiled based mapping services easier. More...

 #include <QGeoTiledMappingManagerEngine>

Inherits: QGeoMappingManagerEngine.

This class was introduced in Qt Mobility 1.1.

Public Functions

virtual ~QGeoTiledMappingManagerEngine ()
virtual QGeoTiledMapReply * getTileImage ( const QGeoTiledMapRequest & request ) = 0
QSize tileSize () const

Reimplemented Public Functions

virtual QGeoMapData * createMapData ()

Protected Functions

QGeoTiledMappingManagerEngine ( const QMap<QString, QVariant> & parameters, QObject * parent = 0 )
void setTileSize ( const QSize & tileSize )

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 QGeoTiledMappingManagerEngine class is provided to make writing Qt Maps and Navigation API plugins for tiled based mapping services easier.

Subclasses of QGeoTiledMappingManagerEngine need to provide an implementation of getTileImage().

It is important that the function setTileSize() is called before getTileImage() to ensure that the tile is dealt with correctly after it is fetched. If setTileSize() is not calle dfirst the behaviour is undefined.

A subclass of QGeoTiledMappingManagerEngine will often make use of a subclass fo QGeoTiledMapReply internally, in order to add any engine-specific data (such as a QNetworkReply object for network-based services) to the QGeoTiledMapReply instances used by the engine.

QGeoTiledMappingManagerEngine will report that custom map objects are supported by default.

Member Function Documentation

QGeoTiledMappingManagerEngine::QGeoTiledMappingManagerEngine ( const QMap<QString, QVariant> & parameters, QObject * parent = 0 ) [protected]

Constructs a new tiled mapping manager using the parameters parameters and the parent parent.

QGeoTiledMappingManagerEngine::~QGeoTiledMappingManagerEngine () [virtual]

Destroys this tiled mapping manager.

QGeoMapData * QGeoTiledMappingManagerEngine::createMapData () [virtual]

Reimplemented from QGeoMappingManagerEngine::createMapData().

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

A QGeoMapData instance contains and manages the information about what a map widget is looking at. A single manager can be used by several QGraphcisGeoMap 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.

The instance returned by the default implementation will be a QGeoTiledMapData instance. Subclasses of QGeoTiledMappingManagerEngine are free to override this function to return subclasses of QGeoTiledMapData in order to customize the map.

This function was introduced in Qt Mobility 1.1.

QGeoTiledMapReply * QGeoTiledMappingManagerEngine::getTileImage ( const QGeoTiledMapRequest & request ) [pure virtual]

Requests the map tiled specified by request.

A QGeoTiledMapReply object will be returned, which can be used to manage the fetching of the tile and to return the tile data.

The returned QGeoTiledMapReply object will emit signals indicating if the operation completes or if errors occur.

Once the operation has completed, QGeoTiledMapReply::mapImageData() and QGeoTiledMapReply::mapImageFormat() can be used to generate the tile image.

The user is responsible for deleting the returned reply object, although this can be done in the slot connected to QGeoTiledMapReply::finished() or QGeoTiledMapReply::error() with deleteLater().

This function was introduced in Qt Mobility 1.1.

void QGeoTiledMappingManagerEngine::setTileSize ( const QSize & tileSize ) [protected]

Sets the size of the tiles returned by this tiled mapping manager to tileSize.

Subclasses of QGeoTiledMappingManagerEngine should use this function to ensure tileSize() provides accurate information.

This function was introduced in Qt Mobility 1.1.

See also tileSize().

QSize QGeoTiledMappingManagerEngine::tileSize () const

Returns the size of the tiles returned by this tiled mapping manager.

This function was introduced in Qt Mobility 1.1.

See also setTileSize().

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.