MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QContactManagerEngineFactory Class Reference

The QContactManagerEngineFactory class provides the interface for plugins that implement QContactManagerEngine functionality. More...

 #include <QContactManagerEngineFactory>

This class was introduced in Qt Mobility 1.0.

Public Functions

virtual ~QContactManagerEngineFactory ()
virtual QContactManagerEngine * engine ( const QMap<QString, QString> & parameters, QContactManager::Error * error ) = 0
virtual QString managerName () const = 0
virtual QList<int> supportedImplementationVersions () const

Detailed Description

The QContactManagerEngineFactory class provides the interface for plugins that implement QContactManagerEngine functionality.

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

More information on writing a contacts engine plugin is available in the Qt Contacts Manager Engines documentation.

See also QContactManager and QContactManagerEngine.

Member Function Documentation

QContactManagerEngineFactory::~QContactManagerEngineFactory () [virtual]

A default, empty destructor.

This function was introduced in Qt Mobility 1.0.

QContactManagerEngine * QContactManagerEngineFactory::engine ( const QMap<QString, QString> & parameters, QContactManager::Error * error ) [pure virtual]

This function is called by the QContactManager 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 QContactManager in return. Any error should be stored in the supplied error reference.

This function was introduced in Qt Mobility 1.0.

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

This function should return a unique string that identifies the engines provided by this factory.

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

This function was introduced in Qt Mobility 1.0.

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

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

This function was introduced in Qt Mobility 1.0.