Calendar API

Up: GEOS SDK TechDocs | Up | Down | Next: 1 Overview

The Nokia 9000i Communicator comes with a calendar application for scheduling appointments and keeping a to-do list. You can add appointments and to-do items with the API defined in calendar.goh; you can also retrieve, modify, and delete events that you have added.

You can search for the existence of any event within a particular time period (including events you did not add yourself); however, Calendar API is not intended for use in retrieving, modifying, or deleting pre-existing events in the user's calendar database.

Calendar API uses IACP (Inter-Application Communication Protocol); your application sends a message to the Calendar application object, which services your request and then returns a status code (and other requested information) with a callback message. Before reading this section, you may wish to review the material on IACP or look at code in the CalApi.goc sample application.

On the Nokia 9000i Communicator, only devices manufactured after February 1997 support this API; your application should check the Calendar application version. Also, only one-time events may be manipulated; this API does not support repeating events.


Up: GEOS SDK TechDocs | Up | Down | Next: 1 Overview