The QVersitOrganizerImporter class converts QVersitDocuments to QOrganizerItems. More...
#include <QVersitOrganizerImporter>
This class was introduced in Qt Mobility 1.1.
enum | Error { NoError, InvalidDocumentError, EmptyDocumentError } |
QVersitOrganizerImporter () | |
QVersitOrganizerImporter ( const QString & profile ) | |
~QVersitOrganizerImporter () | |
QMap<int, Error> | errorMap () const |
bool | importDocument ( const QVersitDocument & document ) |
QList<QOrganizerItem> | items () const |
void | setPropertyHandler ( QVersitOrganizerImporterPropertyHandler * handler ) |
The QVersitOrganizerImporter class converts QVersitDocuments to QOrganizerItems.
This class is used to convert a QVersitDocument (which may be produced by a QVersitReader) to lists of QOrganizerItems (which may be saved into a QOrganizerManager. Unless there is an error, there is a one-to-one mapping between sub-documents of the input Versit document and QOrganizerItems.
This enum specifies an error that occurred during the most recent call to importDocument()
Constant | Value | Description |
---|---|---|
QVersitOrganizerImporter::NoError | 0 | The most recent operation was successful |
QVersitOrganizerImporter::InvalidDocumentError | 1 | One of the documents is not an iCalendar file |
QVersitOrganizerImporter::EmptyDocumentError | 2 | One of the documents is empty |
Constructs a new importer
Constructs a new importer for the given profile. The profile strings should be one of those defined by QVersitOrganizerHandlerFactory, or a value otherwise agreed to by a Versit plugin.
The profile determines which plugins will be loaded to supplement the importer.
Frees the memory used by the importer
Returns the map of errors encountered in the most recent call to importDocument().
The key is the zero based index of the sub document within the container document, or -1 for an error with the container document itself. The value is the error that occurred on that document.
See also importDocument().
Converts document into a corresponding list of QOrganizerItems. After calling this, the converted organizer items can be retrieved by calling items().
Returns true on success. The document should contain at least one subdocument. In the importing process, each subdocument roughly corresponds to a QOrganizerItem. If any of the subdocuments cannot be imported as organizer items (eg. they don't conform to the iCalendar format), false is returned and errorMap() will return a list describing the errors that occurred. The successfully imported items will still be available via items().
See also items() and errorMap().
Returns the organizer items imported in the most recent call to importDocument().
See also importDocument().
Sets handler to be the handler for processing QVersitProperties, or 0 to have no handler.
Does not take ownership of the handler. The client should ensure the handler remains valid for the lifetime of the importer.
Only one property handler can be set. If another property handler was previously set, it will no longer be associated with the importer.