Qt Mobility Reference Documentation

QContactManagerEngineFactory Class Reference

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

 #include <QContactManagerEngineFactory>

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.

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.

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.

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

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

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.