QContactSaveRequest Class Reference

Member Function Documentation

QContactSaveRequest::QContactSaveRequest ( QObject * parent = 0 )

Constructs a new contact save request whose parent is the specified parent

QContactSaveRequest::~QContactSaveRequest ()

Frees any memory used by this request

QList<QContact> QContactSaveRequest::contacts () const

Returns the list of contacts which will be saved if called prior to calling start(), otherwise returns the list of contacts with their ids set appropriately (successfully saved new contacts will have an id assigned).

This function was introduced in Qt Mobility 1.0.

See also setContacts().

QStringList QContactSaveRequest::definitionMask () const

Returns the list of definitions that this request will operate on.

If the list is empty, the request will operate on all details.

See also setDefinitionMask().

QMap<int, QContactManager::Error> QContactSaveRequest::errorMap () const

Returns the map of input contact list indices to errors which occurred

This function was introduced in Qt Mobility 1.0.

void QContactSaveRequest::setContact ( const QContact & contact )

Sets the contact to be saved to contact. Equivalent to calling:

 setContacts(QList<QContact>() << contact);

This function was introduced in Qt Mobility 1.0.

void QContactSaveRequest::setContacts ( const QList<QContact> & contacts )

Sets the list of contacts to be saved to contacts

This function was introduced in Qt Mobility 1.0.

See also contacts().

void QContactSaveRequest::setDefinitionMask ( const QStringList & definitionMask )

Set the list of definitions to restrict saving to definitionMask. This allows you to perform partial save (and remove) operations on existing contacts.

If definitionMask is empty (the default), no restrictions will apply, and the passed in contacts will be saved as is. Otherwise, only details whose definitions are in the list will be saved. If a definition name is present in the list, but there are no corresponding details in the contact passed into this request, any existing details in the manager for that contact will be removed.

This is useful if you've used a fetch hint to fetch a partial contact from a manager so that you can save changes to the details you actually fetched without removing the details you didn't.

Additionally, when performing synchronization operations with other managers that don't support the full range of details, you can restrict the update operation to only those details so that you don't lose the extra details that are supported in this manager.

Note: Some managers do not support partial updates natively, in which case the QtContacts framework will emulate the functionality (fetching the whole contact, applying the new restricted details, and saving the contact back).

See also definitionMask().