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.
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)