QtMobility Reference Documentation

QVersitContactImporterPropertyHandlerV2 Class Reference

The QVersitContactImporterPropertyHandlerV2 class is an interface for specifying custom import behaviour for vCard properties. More...

 #include <QVersitContactImporterPropertyHandlerV2>

Inherited by: QVersitContactHandler.

Public Functions

virtual ~QVersitContactImporterPropertyHandlerV2 ()
virtual void documentProcessed ( const QVersitDocument & document, QContact * contact ) = 0
virtual void propertyProcessed ( const QVersitDocument & document, const QVersitProperty & property, const QContact & contact, bool * alreadyProcessed, QList<QContactDetail> * updatedDetails ) = 0

Detailed Description

The QVersitContactImporterPropertyHandlerV2 class is an interface for specifying custom import behaviour for vCard properties.

This interface supercedes QVersitContactImporterPropertyHandler. For general information on extending Qt Versit, see the document on Versit Plugins.

See also QVersitContactImporter.

Member Function Documentation

QVersitContactImporterPropertyHandlerV2::~QVersitContactImporterPropertyHandlerV2 () [virtual]

Frees any memory in use by this handler.

void QVersitContactImporterPropertyHandlerV2::documentProcessed ( const QVersitDocument & document, QContact * contact ) [pure virtual]

Perform any final processing on the contact generated by the document. This can be implemented by the handler to clear any internal state before moving onto the next document.

This function is called after all QVersitProperties have been handled by the QVersitContactImporter.

void QVersitContactImporterPropertyHandlerV2::propertyProcessed ( const QVersitDocument & document, const QVersitProperty & property, const QContact & contact, bool * alreadyProcessed, QList<QContactDetail> * updatedDetails ) [pure virtual]

Process property and provide a list of updated details by adding them to updatedDetails.

This function is called on every QVersitProperty encountered during an import, after the property has been processed by the QVersitContactImporter. An implementation of this function can be made to provide support for vCard properties not supported by QVersitContactImporter.

The supplied document is the container for the property. alreadyProcessed is true if the QVersitContactImporter or another handler was successful in processing the property. If it is false and the handler processes the property, it should be set to true to inform later handlers that the property requires no further processing. contact holds the state of the contact before the property was processed by the importer. updatedDetails is initially filled with a list of details that the importer will update, and can be modified (by removing, modifying or adding details to the list)

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.