Home · All Classes · Grouped Classes · Annotated · Functions

PIM Library

Overview

The Qtopia PIM library provides a set of APIs for accessing Qtopia PIM data. Classes are provided to retrieve, edit and save Contacts, Tasks, and Appointments. For detailed class information refer to: PIM Class Overview.

The Qtopia PIM library provides unified access to the PIM data on a Qtopia device including concurrent access to PIM data by multiple applications and independence from the mechanism used to store the PIM data on the device.

Concurrent Access to PIM Data

The Qtopia PIM library provides a level of concurrent access to PIM data by multiple applications. The concurrent access does guarantee that data won't be corrupted by concurrent access, however does not give any guarantees as to performance of PIM data access if accessed concurrently by multiple applications.

Abstraction of PIM Data Storage Mechanism

The Qtopia PIM library abstracts the storage method used to store PIM data. On a device the Qtopia PIM library will only read and write the primary storage mechanism and synchronizing mechanism.

PIM Data Synchronization

The Qtopia PIM library prepares the PIM data for synchronizing with Qtopia Sync Agent, as well as integrating updates to the PIM data provided by Qtopia Sync Agent. The Qtopia PIM library however does not monitor notification for start and end of synchronizing, this monitoring is the responsibility of PIM applications.

Sorting, Searching and Filtering Functionality

The Qtopia PIM library provides a number of sort, search and filter functions to aid in selecting data most useful to the view requested. This reduces the burden on the application for managing the PIM data, as well as allowing better use of the underlying storage mechanism.

The design for sorting is to specify a key order and is always done in ascending order.

Preset filters are provided appropriate to each PIM data type. For example filtering by:

Due to the difficulty in predicting all possible ways the data might need to be filtered, filtering that does not fit in the provided functions should be provided by using QProxyModel or accessing the database directly.

Additional PIM Widgets

The Qtopia PIM library provides some GUI controls if they are commonly used by applications casually accessing PIM data. It does not provide GUI controls that are primarily used by PIM applications. For example a Contact selector is provided, but not a Contact edit dialog.

Assumptions and Dependencies

The Qtopia PIM library requires SQL support either through the include SQLite or through some other SQL engine and it also relies on the ability to send and receive QCop messages.

The responsibilities of a PIM application include:

Refer to: Services detailed information on PIM applications.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3