EventList

The three EventLists provide access to the native Calendar database. Each list represents one type of the possible Calendar entries: Appointments, Day Notes, and Anniversaries.

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

In 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.

Appointments

The supported Appointment Event fields are the following:

Table 11: The supported Appointment Event fields

PIM API field

Corresponding Calendar Appointment 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 Appointment 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 Appointments EventList does not support any attributes.

The Appointments EventList does not support categories.

Day notes

The supported Day Note Event fields are the following:

Table 12: The supported Day Note Event fields

PIM API field

Corresponding Calendar Appointment 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 Day Notes EventList does not support any attributes.

The Day Notes EventList does not support categories.

The Day Notes EventList does not support any RepeatRule fields.

Anniversaries

The supported Anniversary Event fields are the following:

Table 13: The supported Anniversary Event fields

PIM API field

Corresponding Calendar Appointment 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 S60

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 2009.