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.
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 Nokia Asha and Series 40 software platform devices.
|
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 |
No |
|
Call |
EventList |
Calendar call entries |
Yes |
No |
|
Birthday |
EventList |
Calendar birthday entries |
Yes |
No |
|
Memo |
EventList |
Calendar memo entries |
Yes |
No |
|
Reminder |
EventList |
Calendar reminder entries |
Yes |
No |
|
Calendar |
Calendar |
Calendar entries |
No |
Yes |
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.