QContactManager Class Reference

bool QContactManager::saveContact ( QContact * contact )

Adds the given contact to the database if contact has a default-constructed id, or an id with the manager URI set to the URI of this manager and a local id of zero.

If the manager URI of the id of the contact is neither empty nor equal to the URI of this manager, or local id of the contact is non-zero but does not exist in the manager, the operation will fail and calling error() will return QContactManager::DoesNotExistError.

Alternatively, the function will update the existing contact in the database if contact has a non-zero id and currently exists in the database.

If the contact contains one or more details whose definitions have not yet been saved with the manager, the operation will fail and calling error() will return QContactManager::UnsupportedError.

If the contact has had its relationships reordered, the manager will check to make sure that every relationship that the contact is currently involved in is included in the reordered list, and that no relationships which either do not involve the contact, or have not been saved in the manager are included in the list. If these conditions are not met, the function will return false and calling error() will return QContactManager::InvalidRelationshipError.

Returns false on failure, or true on success. On successful save of a contact with an id of zero, its id will be set to a new, valid id with the manager URI set to the URI of this manager, and the local id set to a new, valid local id. The manager will automatically synthesize the display label of the contact when it is saved. The manager is not required to fetch updated details of the contact on save, and as such, clients should fetch a contact if they want the most up-to-date information by calling QContactManager::contact().

See also managerUri().

        /* Retrieve a contact */
        QContact c = manager->contact(myId);
        qDebug() << "Current display label" << c.displayLabel();

        /* Update some fields that might influence the display label */
        QContactName name = c.detail<QContactName>();
        name.setFirstName("Abigail");
        name.setLastName("Arkansas");
        c.saveDetail(&name);

        /* Update the display label */
        manager->synthesizeContactDisplayLabel(&c);
        qDebug() << "Now the label is:" << c.displayLabel();