Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QContactContext Class Reference
[QtMessagingModule, QtPimModule, QtTelephonyModule, QtUiModule]

The QContactContext class represents a storage context of contact data. More...

    #include <QContactContext>

Inherits QPimContext.

• List of all members, including inherited members

Public Functions

• virtual QUniqueId addContact ( const QContact & contact, const QPimSource & source )
• virtual QContact exportContact ( const QUniqueId & id, bool & ok ) const
• virtual QList<QContact> exportContacts ( const QPimSource & source, bool & ok ) const
• virtual bool importContact ( const QPimSource & source, const QContact & contact )
• virtual bool importContacts ( const QPimSource & source, const QList<QContact> & contacts )
• virtual bool removeContact ( const QUniqueId & id )
• virtual bool updateContact ( const QContact & contact )

• 14 public functions inherited from QPimContext
• 29 public functions inherited from QObject

Protected Functions

• QContactContext ( QObject * parent = 0 )

• 7 protected functions inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QContactContext class represents a storage context of contact data.

This includes storage contexts such as SIM Card contacts or contacts stored on the phone in the system PIM database. The class can be used to perform operations that relate to a specific context of PIM data.

Currently there is no way for applications to implement their own contexts. This feature is being considered for future versions of Qtopia.

See also QContactModel and Pim Library.

Member Function Documentation

QContactContext::QContactContext ( QObject * parent = 0 )   [protected]

Constructs a QContactContext with parent parent.

QUniqueId QContactContext::addContact ( const QContact & contact, const QPimSource & source )   [virtual]

Adds the contact to the PIM data source if it is controlled by this context. If the contact is successfully added, returns the new unique id for this contact, otherwise returns a null id.

QContact QContactContext::exportContact ( const QUniqueId & id, bool & ok ) const   [virtual]

Exports a single contact identified by id. If successful sets ok to true, otherwise sets ok to false.

See also exportContacts().

QList<QContact> QContactContext::exportContacts ( const QPimSource & source, bool & ok ) const   [virtual]

Exports the contacts stored in the PIM data source and returns them as a list. The source must be controlled by this context. If successful sets ok to true, otherwise sets ok to false.

There isn't necessarily going to be a one to one match to contacts in the PIM data source. Contacts may be merged or split over multiple contacts to form the list.

bool QContactContext::importContact ( const QPimSource & source, const QContact & contact )   [virtual]

Imports a single contact to the PIM data source. If successful returns true, otherwise returns false.

See also importContacts().

bool QContactContext::importContacts ( const QPimSource & source, const QList<QContact> & contacts )   [virtual]

Imports the contacts and merges them with the contacts listed in the PIM data source. The source must be controlled by this context. If successful returns true, otherwise returns false.

There isn't necessarily going to be a one to one match to contacts in the PIM data source. Contacts may be merged or split over multiple contacts. Also contacts that match in name will be updated from the list rather than additional contacts created.

bool QContactContext::removeContact ( const QUniqueId & id )   [virtual]

Removes the contact with the identifier id if it exists in this context. Returns true upon success; otherwise returns false.

bool QContactContext::updateContact ( const QContact & contact )   [virtual]

Updates the contact with the same identifier as contact if it exists in this context. Returns true upon success; otherwise returns false.