CVersitRecurrenceMonthlyByPos Class Reference

#include <app/vrecur.h>

Link against: vcal.lib

class CVersitRecurrenceMonthlyByPos : public CVersitRecurrence

Inherits from

Detailed Description

Defines a list of days when a 'monthly by position' recurrence is to be repeated.

Used by a repeating event (a vCalendar event or to-do) to define when it is to occur.

The days on which the event occurs are identified by their relative position within the month, for example the second Monday or the last Friday.

A pointer to this object may be owned by a CParserPropertyValueRecurrence object

Note: The CMonthPosition class, defined within this class, is used to define the positions of days within the month.

Member Attribute Documentation

iMonthPositions

CArrayPtrFlat< CMonthPosition > *iMonthPositions

Array of 'month positions' which define the days on which the event occurs.

Constructor & Destructor Documentation

CVersitRecurrenceMonthlyByPos ( TInt, TInt, TVersitDateTime *, CArrayPtrFlat< CMonthPosition > * )

IMPORT_CCVersitRecurrenceMonthlyByPos(TIntaInterval,
TIntaDuration,
TVersitDateTime *aEndDate,
CArrayPtrFlat< CMonthPosition > *aMonthPositions
)

Constructs the CVersitRecurrenceMonthlyByPos object.

Sets the interval, the duration, optionally, an end date for the repeat and a pointer to an array of 'month positions', which specify when the event occurs. Also sets the repeat type to EMonthlyByPos.

If a duration and an end date are both specified, the end date takes precedence.

ParameterDescription
aIntervalThe number of months between repeats.
aDurationThe duration, in months, for which the event should recur. A value of zero indicates the repeat should continue forever.
aEndDatePointer to the end date for the repeat event. The object takes ownership of this pointer.
aMonthPositionsPointer to an array of the positions of days within the month. The object takes ownership of this pointer.

~CVersitRecurrenceMonthlyByPos ( )

IMPORT_C~CVersitRecurrenceMonthlyByPos()

Frees all resources owned by the object, prior to its destruction.

Member Function Documentation

ExternalizeOccurrenceListsL ( RWriteStream & )

IMPORT_C voidExternalizeOccurrenceListsL(RWriteStream &aStream)const [virtual]

Reimplemented from CVersitRecurrence::ExternalizeOccurrenceListsL(RWriteStream &)const

Writes the days of the month on which the event occurs to the output stream, aStream.

If an event occurs on Monday and Tuesday of the first week and the second to last week of a month, the string written to aStream would be "1+ MO TU 2- MO TU ", with the plus sign indicating that the week is counted from the start of the month and the minus sign indicating that the week is counted from the end of the month.

ParameterDescription
aStreamThe stream to which the occurrence list is to be written.