QContactChangeSet Class Reference

Member Function Documentation

QContactChangeSet::QContactChangeSet ()

Constructs a new change set

QContactChangeSet::QContactChangeSet ( const QContactChangeSet & other )

Constructs a copy of the other change set

QContactChangeSet::~QContactChangeSet ()

Frees the memory used by this change set

QSet<QContactLocalId> QContactChangeSet::addedContacts () const

Returns the set of ids of contacts which have been added to the database.

QSet<QContactLocalId> QContactChangeSet::addedRelationshipsContacts () const

Returns the set of ids of contacts which have been affected by the addition of relationships to the database.

QSet<QContactLocalId> QContactChangeSet::changedContacts () const

Returns the set of ids of contacts which have been changed in the database.

void QContactChangeSet::clearAddedContacts ()

Clears the set of ids of contacts which have been added to the database

void QContactChangeSet::clearAddedRelationshipsContacts ()

Clears the set of ids of contacts which have been affected by the addition of a relationship to the database.

void QContactChangeSet::clearAll ()

Clears all flags and sets of ids in this change set

void QContactChangeSet::clearChangedContacts ()

Clears the set of ids of contacts which have been changed to the database

void QContactChangeSet::clearRemovedContacts ()

Clears the set of ids of contacts which have been removed to the database

void QContactChangeSet::clearRemovedRelationshipsContacts ()

Clears the set of ids of contacts which have been affected by the removal of a relationship to the database.

bool QContactChangeSet::dataChanged ()

Returns the value of the data changed flag

See also setDataChanged().

void QContactChangeSet::emitSignals ( QContactManagerEngine * engine )

Emits the appropriate signals from the given engine given the state of the change set

void QContactChangeSet::insertAddedContact ( QContactLocalId addedContactId )

Inserts the given contact id addedContactId into the set of ids of contacts which have been added to the database.

void QContactChangeSet::insertAddedContacts ( const QList<QContactLocalId> & addedContactIds )

Inserts each of the given contact ids addedContactIds into the set of ids of contacts which have been added to the database.

void QContactChangeSet::insertAddedRelationshipsContact ( QContactLocalId affectedContactId )

Inserts the given contact id affectedContactId into the set of ids of contacts which have been affected by the addition of a relationship to the database.

void QContactChangeSet::insertAddedRelationshipsContacts ( const QList<QContactLocalId> & affectedContactIds )

Inserts each of the given contact ids affectedContactIds into the set of ids of contacts which have been affected by the addition of a relationship to the database.

void QContactChangeSet::insertChangedContact ( QContactLocalId changedContactId )

Inserts the given contact id changedContactId into the set of ids of contacts which have been changed to the database.

void QContactChangeSet::insertChangedContacts ( const QList<QContactLocalId> & changedContactIds )

Inserts each of the given contact ids changedContactIds into the set of ids of contacts which have been changed to the database.

void QContactChangeSet::insertRemovedContact ( QContactLocalId removedContactId )

Inserts the given contact id removedContactId into the set of ids of contacts which have been removed to the database.

void QContactChangeSet::insertRemovedContacts ( const QList<QContactLocalId> & removedContactIds )

Inserts each of the given contact ids removedContactIds into the set of ids of contacts which have been removed to the database.

void QContactChangeSet::insertRemovedRelationshipsContact ( QContactLocalId affectedContactId )

Inserts the given contact id affectedContactId into the set of ids of contacts which have been affected by the removal of a relationship to the database.

void QContactChangeSet::insertRemovedRelationshipsContacts ( const QList<QContactLocalId> & affectedContactIds )

Inserts each of the given contact ids affectedContactIds into the set of ids of contacts which have been affected by the removal of a relationship to the database.

QPair<QContactLocalId, QContactLocalId> QContactChangeSet::oldAndNewSelfContactId () const

Returns the pair of ids which represents the old and new self contact ids. The first id in the pair is the old self contact id, while the second id in the pair is the new self contact id. If the new id is different to the old id at the point in time when emitSignals() is called, the QContactManagerEngine::selfContactIdChanged() signal will be emitted.

See also setOldAndNewSelfContactId().

QSet<QContactLocalId> QContactChangeSet::removedContacts () const

Returns the set of ids of contacts which have been removed from the database.

QSet<QContactLocalId> QContactChangeSet::removedRelationshipsContacts () const

Returns the set of ids of contacts which have been affected by the removal of relationships from the database.

void QContactChangeSet::setDataChanged ( bool dataChanged )

Sets the data changed flag to dataChanged. If this is set to true prior to calling emitSignals(), only the QContactManagerEngine::dataChanged() signal will be emitted; otherwise, the appropriate finer-grained signals will be emitted.

See also dataChanged().

void QContactChangeSet::setOldAndNewSelfContactId ( const QPair<QContactLocalId, QContactLocalId> & oldAndNewContactId )

Sets the pair of ids which represent the old and new self contact ids to the given pair of ids oldAndNewContactId. The first id in the pair is the old self contact id, while the second id in the pair is the new self contact id. If the new id is different to the old id at the point in time when emitSignals() is called, the QContactManagerEngine::selfContactIdChanged signal will be emitted.

See also oldAndNewSelfContactId().

QContactChangeSet & QContactChangeSet::operator= ( const QContactChangeSet & other )

Assigns this change set to be equal to other