Adding a User-Defined 32-bit Field

Overview

CCalEntry class allows a user-defined 32-bit field to be stored and retrieved through the entry. This is helpful in cases where a user wishes to add a field in an entry. The property of the field can be customised to contain required data, for example:

• The ID of the originating message, to improve messaging integration with Calendar

• Whether the event has been sent from the device since being edited

• Whether the event has ever been sent from the device (affects UI interaction)

• Whether the event was created by Microsoft iCalendar with the bad Recurrence ID.

The user is able to store and retrieve specific features for that entry.

Get and set the value of the user integer

The API CCalEntry::SetUserIntL(TUint32) sets the integer for a specific entry, where TUint32 is the unsigned integer.

The API TUint32 CCalEntry::GetUserInt() gets the value of a user integer.

Import and export of a property

When importing a vCalendar file, the property X-SYMBIAN-USERINT is read and converted to the calendar entry.

When exporting a calendar entry the value of the user integer is exported as a user-defined property X-SYMBIAN-USERINT in a vCalendar file.