QtMobility Reference Documentation

QContactChangeSet Class Reference

The QContactChangeSet class provides a simple API to simplify the emission of state-change signals from QContactManagerEngine implementations. More...

 #include <QContactChangeSet>

This class was introduced in Qt Mobility 1.0.

Public Functions

QContactChangeSet ()
QContactChangeSet ( const QContactChangeSet & other )
~QContactChangeSet ()
QSet<QContactLocalId> addedContacts () const
QSet<QContactLocalId> addedRelationshipsContacts () const
QSet<QContactLocalId> changedContacts () const
void clearAddedContacts ()
void clearAddedRelationshipsContacts ()
void clearAll ()
void clearChangedContacts ()
void clearRemovedContacts ()
void clearRemovedRelationshipsContacts ()
bool dataChanged ()
void emitSignals ( QContactManagerEngine * engine )
void insertAddedContact ( QContactLocalId addedContactId )
void insertAddedContacts ( const QList<QContactLocalId> & addedContactIds )
void insertAddedRelationshipsContact ( QContactLocalId affectedContactId )
void insertAddedRelationshipsContacts ( const QList<QContactLocalId> & affectedContactIds )
void insertChangedContact ( QContactLocalId changedContactId )
void insertChangedContacts ( const QList<QContactLocalId> & changedContactIds )
void insertRemovedContact ( QContactLocalId removedContactId )
void insertRemovedContacts ( const QList<QContactLocalId> & removedContactIds )
void insertRemovedRelationshipsContact ( QContactLocalId affectedContactId )
void insertRemovedRelationshipsContacts ( const QList<QContactLocalId> & affectedContactIds )
QPair<QContactLocalId, QContactLocalId> oldAndNewSelfContactId () const
QSet<QContactLocalId> removedContacts () const
QSet<QContactLocalId> removedRelationshipsContacts () const
void setDataChanged ( bool dataChanged )
void setOldAndNewSelfContactId ( const QPair<QContactLocalId, QContactLocalId> & oldAndNewContactId )
QContactChangeSet & operator= ( const QContactChangeSet & other )

Detailed Description

The QContactChangeSet class provides a simple API to simplify the emission of state-change signals from QContactManagerEngine implementations.

This class can be utilised by backend implementations to ensure correct emission of the QContactManagerEngine::dataChanged(), QContactManagerEngine::contactsAdded(), QContactManagerEngine::contactsChanged() and QContactManagerEngine::contactsRemoved().

See also QContactManagerEngine.

Member Function Documentation

QContactChangeSet::QContactChangeSet ()

Constructs a new change set

QContactChangeSet::QContactChangeSet ( const QContactChangeSet & other )

Constructs a copy of the other change set

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

QSet<QContactLocalId> QContactChangeSet::addedRelationshipsContacts () const

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

This function was introduced in Qt Mobility 1.0.

QSet<QContactLocalId> QContactChangeSet::changedContacts () const

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

This function was introduced in Qt Mobility 1.0.

void QContactChangeSet::clearAddedContacts ()

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

This function was introduced in Qt Mobility 1.0.

void QContactChangeSet::clearAddedRelationshipsContacts ()

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

This function was introduced in Qt Mobility 1.0.

void QContactChangeSet::clearAll ()

Clears all flags and sets of ids in this change set

This function was introduced in Qt Mobility 1.0.

void QContactChangeSet::clearChangedContacts ()

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

This function was introduced in Qt Mobility 1.0.

void QContactChangeSet::clearRemovedContacts ()

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

This function was introduced in Qt Mobility 1.0.

void QContactChangeSet::clearRemovedRelationshipsContacts ()

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

This function was introduced in Qt Mobility 1.0.

bool QContactChangeSet::dataChanged ()

Returns the value of the data changed flag

This function was introduced in Qt Mobility 1.0.

See also setDataChanged().

void QContactChangeSet::emitSignals ( QContactManagerEngine * engine )

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

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

See also setOldAndNewSelfContactId().

QSet<QContactLocalId> QContactChangeSet::removedContacts () const

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

This function was introduced in Qt Mobility 1.0.

QSet<QContactLocalId> QContactChangeSet::removedRelationshipsContacts () const

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

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

See also oldAndNewSelfContactId().

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

Assigns this change set to be equal to other

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.