MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QLandmarkManagerEngineFactory Class Reference

The QLandmarkManagerEngineFactory class provides the interface for plugins that implement QLandmarkManagerEngine functionality. More...

 #include <QLandmarkManagerEngineFactory>

This class was introduced in Qt Mobility 1.1.

Public Functions

virtual ~QLandmarkManagerEngineFactory ()
virtual QLandmarkManagerEngine * engine ( const QMap<QString, QString> & parameters, QLandmarkManager::Error * error, QString * errorString ) = 0
virtual QString managerName () const = 0
virtual QList<int> supportedImplementationVersions () const

Detailed Description

The QLandmarkManagerEngineFactory class provides the interface for plugins that implement QLandmarkManagerEngine functionality.

This class provides a simple interface for the creation of landmark manager engine instances. Each factory has a specific id associated with it, which forms the managerName parameter when creating QLandmarkManager objects.

See also QLandmarkManager and QLandmarkManagerEngine.

Member Function Documentation

QLandmarkManagerEngineFactory::~QLandmarkManagerEngineFactory () [virtual]

Destroys the engine factory.

QLandmarkManagerEngine * QLandmarkManagerEngineFactory::engine ( const QMap<QString, QString> & parameters, QLandmarkManager::Error * error, QString * errorString ) [pure virtual]

This function is called by the QLandmarkManager implementation to create an instance of the engine provided by this factory.

The parameters supplied can be ignored or interpreted as desired.

If a supplied parameter results in an unfulfillable request, or some other error occurs, this function may return a null pointer, and the client developer will get an invalid QLandmarkManager in return. Errors are stored in error and errorString.

This function was introduced in Qt Mobility 1.1.

QString QLandmarkManagerEngineFactory::managerName () const [pure virtual]

This function returns a unique string that identifies the engine provided by this factory.

Typically this would be of the form "com.nokia.qt.landmarks.engines.sqlite", with the appropriate domain and engine name substituted.

This function was introduced in Qt Mobility 1.1.

QList<int> QLandmarkManagerEngineFactory::supportedImplementationVersions () const [virtual]

This function returns a list of versions of the engine which this factory can instantiate.