Contacts Model Overview

Stores, manipulates and retrieves Contacts data.

Contacts data is used by contacts management PIM applications.

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

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

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.

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.

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.

Versit Overview