Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Contacts Model Overview


Purpose

Stores, manipulates and retrieves Contacts data.

Contacts is a PIM application for contacts management.

[Top]


Architectural relationships

The API uses the Versit API to import and export vCards.

[Top]


Description

The API has three key concepts: contact database, contact item, and contact field.


Contact database

The contact database class allows clients to create a new contacts database, or open an existing one. A database can be searched, sorted, and contact items can be edited, read, added, and deleted.

The contact database class is CContactDatabase.

A contact database observer can be notified of database changes made by other clients. The observer interface is provided by MContactDbObserver.

A view definition for the item may be specified to indicate which field data should be retrieved. It is provided by CContactItemViewDef.


Contact item

The contact item is an element in a contact database. Each contact item is made up of a number of fields, e.g. First name. Fields can be accessed, and added and removed from an item.

The contact item interface is provided by the base class CContactItem.

The contact card extends the base class for a concrete item. It is provided by CContactCard.

The contact item template also extends the base class. It is used to set the initial fields for other contact items. It is provided by CContactTemplate.


Contact field

The contact field provides storage for a single value. This value may be text, binary, or date/time.

The contact field interface is provided by CContactItemField.

The contact item field set groups together the fields for a contact item. It is provided by CContactItemFieldSet.

[Top]


See also

Versit Overview