Qt API | Qtopia API | Qtopia Documentation |

# QPEPIM Library Overview

- Introduction
- PIM Change signals
- Data Refresh

## Introduction

The QPEPIM Access library provides a set of safe APIs for accessing Qtopia PIM data and provides a smooth transition to the next major revision of Qtopia. Specifically, classes are provided to retrieve, edit, and save Contacts, Tasks, and Events. The access classes attempt to keep themselves in sync with Qtopia's AddressBook, Todo, and Datebook applications, and any other applications.

## PIM Change signals

The access class listen for various QCop calls to keep in sync with the main pim applications. When an access class detects an update it will emit a signal indicating it has been udpated.

## Data Refresh

QPEPIM will always try to return the most current data to the user. This is done by monitoring the time stamp on the actual data file as well as listening for QPE/PIM messages that are relavent to the data files used by the specific accessor. If a QPE/PIM message is received that indicates the data has been updated the accessor will emit a signal indicating the event and during the next data query QPEPIM will refresh its internal caches. Note that since QPEPIM does not employ a polling mechanism simply touching the data file will not trigger the event to be emitted, however it will be detected the next time data is requested.