Qt Mobility Reference Documentation

QContactMemoryEngine Class Reference

The QContactMemoryEngine class provides an in-memory implementation of a contacts backend. More...

 #include <QContactMemoryEngine>

Inherits QContactManagerEngine.

Inherited by QContactSimulatorEngine.


Public Functions

~QContactMemoryEngine ()

Reimplemented Public Functions

virtual bool cancelRequest ( QContactAbstractRequest * req )
virtual QContact contact ( const QContactLocalId & contactId, const QContactFetchHint & fetchHint, QContactManager::Error * error ) const
virtual QList<QContact> contacts ( const QContactFilter & filter, const QList<QContactSortOrder> & sortOrders, const QContactFetchHint & fetchHint, QContactManager::Error * error ) const
virtual bool hasFeature ( QContactManager::ManagerFeature feature, const QString & contactType ) const
virtual bool isFilterSupported ( const QContactFilter & filter ) const
virtual bool isRelationshipTypeSupported ( const QString & relationshipType, const QString & contactType ) const
virtual QString managerName () const
virtual QMap<QString, QString> managerParameters () const
virtual QList<QContactRelationship> relationships ( const QString & relationshipType, const QContactId & participantId, QContactRelationship::Role role, QContactManager::Error * error ) const
virtual bool removeContacts ( const QList<QContactLocalId> & contactIds, QMap<int, QContactManager::Error> * errorMap, QContactManager::Error * error )
virtual bool removeDetailDefinition ( const QString & definitionId, const QString & contactType, QContactManager::Error * error )
virtual bool removeRelationships ( const QList<QContactRelationship> & relationships, QMap<int, QContactManager::Error> * errorMap, QContactManager::Error * error )
virtual void requestDestroyed ( QContactAbstractRequest * req )
virtual bool saveContacts ( QList<QContact> * contacts, QMap<int, QContactManager::Error> * errorMap, QContactManager::Error * error )
virtual bool saveRelationships ( QList<QContactRelationship> * relationships, QMap<int, QContactManager::Error> * errorMap, QContactManager::Error * error )
virtual QContactLocalId selfContactId ( QContactManager::Error * error ) const
virtual bool startRequest ( QContactAbstractRequest * req )
virtual QList<QVariant::Type> supportedDataTypes () const
virtual bool waitForRequestFinished ( QContactAbstractRequest * req, int msecs )

Static Public Members

QContactMemoryEngine * createMemoryEngine ( const QMap<QString, QString> & parameters )

Protected Functions

QContactMemoryEngine ( QContactMemoryEngineData * data )
virtual bool removeContact ( const QContactLocalId & contactId, QContactChangeSet & changeSet, QContactManager::Error * error )
virtual bool removeDetailDefinition ( const QString & definitionId, const QString & contactType, QContactChangeSet & changeSet, QContactManager::Error * error )
virtual bool removeRelationship ( const QContactRelationship & relationship, QContactChangeSet & changeSet, QContactManager::Error * error )
virtual bool saveContact ( QContact * theContact, QContactChangeSet & changeSet, QContactManager::Error * error )
virtual bool saveDetailDefinition ( const QContactDetailDefinition & def, const QString & contactType, QContactChangeSet & changeSet, QContactManager::Error * error )
virtual bool saveRelationship ( QContactRelationship * relationship, QContactChangeSet & changeSet, QContactManager::Error * error )

Additional Inherited Members


Detailed Description

The QContactMemoryEngine class provides an in-memory implementation of a contacts backend.

It may be used as a reference implementation, or when persistent storage is not required.

During construction, it will load the in-memory data associated with the memory store identified by the "id" parameter from the given parameters if it exists, or a new, anonymous store if it does not.

Data stored in this engine is only available in the current process.

This engine supports sharing, so an internal reference count is increased whenever a manager uses this backend, and is decreased when the manager no longer requires this engine.


Member Function Documentation

QContactMemoryEngine::QContactMemoryEngine ( QContactMemoryEngineData * data ) [protected]

Constructs a new in-memory backend which shares the given data with other shared memory engines.

QContactMemoryEngine::~QContactMemoryEngine ()

Frees any memory used by this engine

bool QContactMemoryEngine::cancelRequest ( QContactAbstractRequest * req ) [virtual]

Reimplemented from QContactManagerEngine::cancelRequest().

QContact QContactMemoryEngine::contact ( const QContactLocalId & contactId, const QContactFetchHint & fetchHint, QContactManager::Error * error ) const [virtual]

Reimplemented from QContactManagerEngine::contact().

QList<QContact> QContactMemoryEngine::contacts ( const QContactFilter & filter, const QList<QContactSortOrder> & sortOrders, const QContactFetchHint & fetchHint, QContactManager::Error * error ) const [virtual]

Reimplemented from QContactManagerEngine::contacts().

QContactMemoryEngine * QContactMemoryEngine::createMemoryEngine ( const QMap<QString, QString> & parameters ) [static]

Factory function for creating a new in-memory backend, based on the given parameters.

The same engine will be returned for multiple calls with the same value for the "id" parameter, while one of them is in scope.

bool QContactMemoryEngine::hasFeature ( QContactManager::ManagerFeature feature, const QString & contactType ) const [virtual]

Reimplemented from QContactManagerEngine::hasFeature().

bool QContactMemoryEngine::isFilterSupported ( const QContactFilter & filter ) const [virtual]

Reimplemented from QContactManagerEngine::isFilterSupported().

The function returns true if the backend natively supports the given filter filter, otherwise false.

bool QContactMemoryEngine::isRelationshipTypeSupported ( const QString & relationshipType, const QString & contactType ) const [virtual]

Reimplemented from QContactManagerEngine::isRelationshipTypeSupported().

QString QContactMemoryEngine::managerName () const [virtual]

Reimplemented from QContactManagerEngine::managerName().

QMap<QString, QString> QContactMemoryEngine::managerParameters () const [virtual]

Reimplemented from QContactManagerEngine::managerParameters().

QList<QContactRelationship> QContactMemoryEngine::relationships ( const QString & relationshipType, const QContactId & participantId, QContactRelationship::Role role, QContactManager::Error * error ) const [virtual]

Reimplemented from QContactManagerEngine::relationships().

bool QContactMemoryEngine::removeContact ( const QContactLocalId & contactId, QContactChangeSet & changeSet, QContactManager::Error * error ) [virtual protected]

Removes the contact identified by the given contactId, storing any error to error and filling the changeSet with ids of changed contacts and relationships as required

bool QContactMemoryEngine::removeContacts ( const QList<QContactLocalId> & contactIds, QMap<int, QContactManager::Error> * errorMap, QContactManager::Error * error ) [virtual]

Reimplemented from QContactManagerEngine::removeContacts().

bool QContactMemoryEngine::removeDetailDefinition ( const QString & definitionId, const QString & contactType, QContactManager::Error * error ) [virtual]

Reimplemented from QContactManagerEngine::removeDetailDefinition().

bool QContactMemoryEngine::removeDetailDefinition ( const QString & definitionId, const QString & contactType, QContactChangeSet & changeSet, QContactManager::Error * error ) [virtual protected]

Removes the detail definition identified by definitionId, storing any error to error and filling the changeSet with ids of changed contacts as required

bool QContactMemoryEngine::removeRelationship ( const QContactRelationship & relationship, QContactChangeSet & changeSet, QContactManager::Error * error ) [virtual protected]

Removes the given relationship relationship, storing any error to error and filling the changeSet with ids of changed contacts and relationships as required

bool QContactMemoryEngine::removeRelationships ( const QList<QContactRelationship> & relationships, QMap<int, QContactManager::Error> * errorMap, QContactManager::Error * error ) [virtual]

Reimplemented from QContactManagerEngine::removeRelationships().

void QContactMemoryEngine::requestDestroyed ( QContactAbstractRequest * req ) [virtual]

Reimplemented from QContactManagerEngine::requestDestroyed().

bool QContactMemoryEngine::saveContact ( QContact * theContact, QContactChangeSet & changeSet, QContactManager::Error * error ) [virtual protected]

Saves the given contact theContact, storing any error to error and filling the changeSet with ids of changed contacts as required

bool QContactMemoryEngine::saveContacts ( QList<QContact> * contacts, QMap<int, QContactManager::Error> * errorMap, QContactManager::Error * error ) [virtual]

Reimplemented from QContactManagerEngine::saveContacts().

bool QContactMemoryEngine::saveDetailDefinition ( const QContactDetailDefinition & def, const QString & contactType, QContactChangeSet & changeSet, QContactManager::Error * error ) [virtual protected]

Saves the given detail definition def, storing any error to error and filling the changeSet with ids of changed contacts as required

bool QContactMemoryEngine::saveRelationship ( QContactRelationship * relationship, QContactChangeSet & changeSet, QContactManager::Error * error ) [virtual protected]

Saves the given relationship relationship, storing any error to error and filling the changeSet with ids of changed contacts and relationships as required

bool QContactMemoryEngine::saveRelationships ( QList<QContactRelationship> * relationships, QMap<int, QContactManager::Error> * errorMap, QContactManager::Error * error ) [virtual]

Reimplemented from QContactManagerEngine::saveRelationships().

QContactLocalId QContactMemoryEngine::selfContactId ( QContactManager::Error * error ) const [virtual]

Reimplemented from QContactManagerEngine::selfContactId().

bool QContactMemoryEngine::startRequest ( QContactAbstractRequest * req ) [virtual]

Reimplemented from QContactManagerEngine::startRequest().

QList<QVariant::Type> QContactMemoryEngine::supportedDataTypes () const [virtual]

Reimplemented from QContactManagerEngine::supportedDataTypes().

bool QContactMemoryEngine::waitForRequestFinished ( QContactAbstractRequest * req, int msecs ) [virtual]

Reimplemented from QContactManagerEngine::waitForRequestFinished().

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.