Class and interface support

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.

Symbian implementation

The implementation supports PIMLists as described in the following table, ordered:

**Table:** The `PIMLists` supported by the implementation
List name	List type	Corresponding PIM data
Contacts	`ContactList`	Phonebook entries in device memory
Appointments	`EventList`	Calendar Appointment entries
Day notes	`EventList`	Calendar Day Note entries
Anniversaries	`EventList`	Calendar Anniversary entries
To-do notes	`ToDoList`	To-do list entries

The list names depend on the used localization variant. For more information, see the section Runtime environment.

The Contact, Day notes and To-do notes 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.

The 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. In the Series 40 implementation, these confirmation dialogs are suppressed when the API is used from the Manufacturer security domain.

In the Series 40 implementation, the method call PIM.listPIMLists(PIM.EVENT_LIST) returns the following array of list names in this order:

{"Meeting", "Call", "Birthday", "Memo", "Reminder"}

or their localized equivalents in the selected UI language.

**Table:** The `PIMLists` supported by the implementation
List name	List type	Corresponding PIM data
Contacts	`ContactList`	Phonebook entries in device memory
Contacts	`ContactList`	Phonebook entries in SIM
Meeting	`EventList`	Calendar Appointment entries
Call	`EventList`	Calendar Call entries
Birthday	`EventList`	Calendar Birthday entries
Memo	`EventList`	Calendar Memo entries
Reminder	`EventList`	Calendar Reminder entries
ToDo	`ToDoList`	To-do list entries

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.