| class CParserPropertyValueRecurrence : public CParserTimePropertyValue |
A recurrence property value parser.
This is used to store and retrieve the recurrence information for a repeating vEvent or vTodo. This information is stored as a CVersitRecurrence object.
The UID for a recurrence property value is KVCalPropertyRecurrenceUid.
| Public Member Functions | |
|---|---|
| CParserPropertyValueRecurrence ( CVersitRecurrence *) | |
| ~CParserPropertyValueRecurrence () | |
| IMPORT_C void | ConvertAllDateTimesToUTCL (const TTimeIntervalSeconds &, const CVersitDaylight *) |
| IMPORT_C void | ConvertAllUTCDateTimesToMachineLocalL (const TTimeIntervalSeconds &) |
| IMPORT_C void | ExternalizeL ( RWriteStream &, const Versit::TEncodingAndCharset &, TInt ) |
| CVersitRecurrence * | Value () |
| Protected Attributes | |
|---|---|
| CVersitRecurrence * | iValue |
| IMPORT_C | CParserPropertyValueRecurrence | ( | CVersitRecurrence * | aValue | ) |
Constructs a recurrence property value.
Sets the property value's UID to KVCalPropertyRecurrenceUid.
| CVersitRecurrence * aValue | A pointer to the recurrence value to assign to the property value parser. The property value parser takes ownership of the pointer. |
| IMPORT_C | ~CParserPropertyValueRecurrence | ( | ) |
Frees all resources owned by the property value, prior to its destruction.
| IMPORT_C void | ConvertAllDateTimesToUTCL | ( | const TTimeIntervalSeconds & | aIncrement, |
| const CVersitDaylight * | aDaylight | |||
| ) | [virtual] | |||
Converts the end time of the recurrence value into universal time.
The date/time is checked against the daylight saving information provided in aDaylight. If it falls inside the daylight saving period then the daylight saving offset is subtracted from the time to convert it to universal time. Otherwise the time is modified by aIncrement to convert it to universal time.
Note that the daylight savings offset will adjust the time both for the daylight saving and for the time zone.
The function has no effect if the value is already stored in universal time.
If aDaylight is a NULL pointer then aIncrement is used.
since 9.1
| const TTimeIntervalSeconds & aIncrement | A time interval in seconds which represents the negative of the time zone of the originating machine. For instance, if the time zone is +04:30 (that is 4hr 30mins ahead of UTC), aIncrement should be set to minus the number of seconds in 4hr 30mins.. |
| const CVersitDaylight * aDaylight | Pointer to the specification for daylight saving. If the date/time value is within the period for daylight saving, the value is modified by the daylight saving offset (which accounts for both the time zone and daylight saving rule). |
| IMPORT_C void | ConvertAllUTCDateTimesToMachineLocalL | ( | const TTimeIntervalSeconds & | aIncrement | ) | [virtual] |
Converts the end time of the recurrence value into machine-local time.
This process involves adjusting the date/time value by the offset in aIncrement.
The function has no effect if the value is already stored in machine-local time.
since 9.1
| const TTimeIntervalSeconds & aIncrement | A time interval which represents the number of seconds which is to be added to the date/time value. This should normally be the universal time offset for the machine's locale. |
| IMPORT_C void | ExternalizeL | ( | RWriteStream & | aStream, |
| const Versit::TEncodingAndCharset & | , | |||
| TInt | ||||
| ) | [virtual] | |||
Externalises the recurrence property value into aStream.
The property is written to the stream in the following order:
Repeat type, e.g. "D" is written for a daily repeat (see KVersitRecurrenceDaily).
Repeat interval, e.g. "2" for a weekly repeat type that occurs fortnightly.
Occurrence list (optional), e.g. the string "MO TH" is written for a weekly repeat type that recurs on Mondays and Thursdays.
End date (optional) - the date on which the event should stop recurring.
Duration, e.g. "#10" for a weekly repeat type that should last for 10 weeks.
For example, "W2 TU TH #10", means a repeat every second Tuesday and Thursday for 10 weeks
| RWriteStream & aStream | Stream to which the value is to be externalised. |
| const Versit::TEncodingAndCharset & | |
| TInt |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.