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.