EventList in Symbian

EventLists provide access to the calendar databases available on a device. Each list contains calendar entries of a specific type:

  • Meetings

  • Memos

  • Anniversaries

The EventLists do not support all valid values for RepeatRule.FREQUENCY and RepeatRule.INTERVAL fields. The details are in the corresponding sections.

In the PIM API, there are no methods for informing the API user about valid RepeatRule values. (EventList.getSupportedRepeatRuleFields() provides only the valid field combinations.) Invalid RepeatRule values cause PIMItem.commit() to be rejected (throwing a PIMException) or the values to be silently changed to valid ones, if possible.

Meetings

The supported meeting Event fields are the following:

Table: Supported meeting Event fields

PIM API field

Corresponding calendar meeting field

Event.SUMMARY

Subject

Event.NOTE

Description

Event.LOCATION

Location

Event.START

Start date/time

Event.END

End date/time

Event.ALARM

Alarm

Event.CLASS

Synchronization

Event.UID

(Internal unique identifier)

Event.REVISION

(Internal last modification date)

The supported meeting RepeatRule field combinations are the following:

  • RepeatRule.FREQUENCY + RepeatRule.END

  • RepeatRule.FREQUENCY + RepeatRule.INTERVAL + RepeatRule.END

The supported values for RepeatRule.FREQUENCY are the following:

  • RepeatRule.DAILY

  • RepeatRule.WEEKLY

  • RepeatRule.MONTHLY

  • RepeatRule.YEARLY

For frequency RepeatRule.WEEKLY only intervals 1 and 2 are supported. For other frequencies, only interval 1 is supported.

The meeting EventList does not support any attributes.

The meeting EventList does not support categories.

Memos

Note: From Symbian^3 onwards, the native calendar database no longer supports memo entries. If a MIDlet tries to create a memo entry, the entry is saved as an all-day meeting entry.

The supported memo Event fields are the following:

Table: Supported memo Event fields

PIM API field

Corresponding calendar memo field

Event.SUMMARY

Subject

Event.NOTE

Description

Event.START

Start date

Event.END

End date

Event.CLASS

Synchronization

Event.UID

(Internal unique identifier)

Event.REVISION

(Internal last modification date)

Event.ALARM

(Since S60 5th Edition)

Alarm

The memo EventList does not support any attributes.

The memo EventList does not support categories.

The memo EventList does not support any RepeatRule fields.

Anniversaries

The supported anniversary Event fields are the following:

Table: Supported anniversary Event fields

PIM API field

Corresponding calendar anniversary field

Event.SUMMARY

Occasion

Event.NOTE

Description

Event.START

Start date

Event.ALARM

Alarm

Event.END

End date

Event.CLASS

Synchronization

Event.UID

(Internal unique identifier)

Event.REVISION

(Internal last modification date)

The supported anniversary RepeatRule field combinations are as follows:

  • RepeatRule.FREQUENCY

The only supported RepeatRule.FREQUENCY value is RepeatRule.YEARLY.

The anniversary EventList does not support any attributes.

The anniversary EventList does not support categories.

Unsupported in the Symbian platform

Unsupported RepeatRule fields:

  • RepeatRule.COUNT

  • RepeatRule.MONTH_IN_YEAR

  • RepeatRule.DAY_IN_WEEK

  • RepeatRule.WEEK_IN_MONTH

  • RepeatRule.DAY_IN_MONTH

  • RepeatRule.DAY_IN_YEAR

EventLists do not support any attributes.

EventLists do not support categories.

© Nokia 2011.