Class and interface description

This section lists the implementation specifics of the Personal Information Management API at package level.

The javax.microedition.pim package contains PIM API classes and interfaces.

The PIMList.getFieldLabel(), PIMList.getAttributeLabel(), and PIMList.getArrayElementLabel() methods should be used for obtaining localized labels for fields, attributes, and string array elements.

Series 40 implementation

Note: Although the PIM API does not constitute any explicit UI components, the implementation shows an extra confirmation dialog for item and category deletion operations.

The PIM.listPIMLists(PIM.EVENT_LIST) method returns the supported EventList names in the following order:

Meeting
Call
Birthday
Memo
Reminder

The exact names returned by the method are localized and can also depend on the platform.

The following table describes the PIMLists supported by Series 40 and Nokia Asha software platform devices.

**Table:** PIMLists supported by Series 40 and Nokia Asha software platform
List name	Class	Corresponding PIM data	Support on Series 40	Support on Nokia Asha software platform 1.0
Contacts	`ContactList`	Phonebook entries in device memory	Yes	Yes
Contacts	`ContactList`	Phonebook entries in SIM	Yes	Yes
Meeting	`EventList`	Calendar meeting entries	Yes	Yes
Call	`EventList`	Calendar call entries	Yes	Yes
Birthday	`EventList`	Calendar birthday entries	Yes	Yes
Memo	`EventList`	Calendar memo entries	Yes	Yes
Reminder	`EventList`	Calendar reminder entries	Yes	Yes
ToDo	`ToDoList`	To-do note entries	Yes	No

The Contact, Event, and ToDo item objects in lists are persistent so that they are read from the database during list initialization. After this, external changes are applied to the items so that there is no need to reread entire lists. The items are refreshed from a native database whenever any of the PIMList.items variations is called.