IRecurrencePattern
The IRecurrencePattern interface provides read-write access to tasks and appointment recurrence patterns.
You get an IRecurrencePattern object by calling either ITask::GetRecurrencePattern or IAppointment::GetRecurrencePattern.
Methods in Vtable Order
| IRecurrencePattern methods | PPC | SP | Description |
|---|---|---|---|
| get_RecurrenceType | X | X | Gets an integer value that represents the recurrence type for an appointment or task. |
| get_PatternStartDate | X | X | Gets a Variant time date object that represents the start date of the recurrence pattern. |
| get_StartTime | X | X | Gets a Variant time date object that represents the start time for a recurring appointment. |
| get_EndTime | X | X | Gets a Variant time date object that represents the end of a recurring appointment. |
| get_PatternEndDate | X | X | Gets a Variant time date object that represents the end date of the recurrence. |
| get_NoEndDate | X | X | Gets a Boolean value indicating whether the recurrence has an end date. |
| get_Occurrences | X | X | Gets an integer value indicating the number of occurrences in the recurrence pattern. |
| get_Interval | X | X | Gets the number of units between occurrences (days, weeks, months), from 1 to 999. |
| get_DayOfWeekMask | X | X | Gets a bitmask that represents the combination of OlDaysOfWeek enumeration values that make up a recurrence pattern. |
| get_DayOfMonth | X | X | Gets a value between 1 and 31, inclusive, that represents a recurrence pattern expressed as a day of the month. |
| get_Instance | X | X | Gets an integer value between 1 and 5, inclusive, that represents a recurrence pattern expressed as a week of the month. |
| get_Duration | X | X | Gets the length of a recurring appointment. |
| get_MonthOfYear | X | X | Gets an integer value between 1 and 12, inclusive, that represents a recurrence pattern expressed as a month of the year. |
| put_RecurrenceType | X | X | Sets the type of recurrence for Appointment and Task items. |
| put_PatternStartDate | X | X | Sets the start date of the recurrence pattern. |
| put_StartTime | X | X | Sets the start time of the recurrence pattern. |
| put_EndTime | X | X | Sets the end time of the recurrence pattern. |
| put_PatternEndDate | X | X | Sets the end date of the recurrence pattern. |
| put_NoEndDate | X | X | Sets a Boolean value indicating whether the recurrence pattern has an end date. |
| put_Occurrences | X | X | Sets the number of occurrences in the recurrence pattern. |
| put_Interval | X | X | Sets the time span between occurrences (days, weeks, months), from 1 to 999. |
| put_DayOfWeekMask | X | X | Sets a bitmask that represents the combination of OlDaysOfWeek enumeration values that make up a recurrence pattern. |
| put_DayOfMonth | X | X | Sets a recurrence pattern expressed as a day of the month. |
| put_Instance | X | X | Sets the duration of a recurrence pattern expressed as a day of the week, a week of the month, or a month of the year. |
| put_Duration | X | X | Sets the duration of a recurrence pattern expressed as a day of the week, a week of the month, or a month of the year. |
| put_MonthOfYear | X | X | Sets a recurrence pattern expressed as a month of the year. |
| get_Exceptions | X | X | Gets a collection of exceptions that are associated with a recurring appointment object. |
| get_Application | X | X | Gets the main Outlook Mobile IPOutlookApp object. |
| GetOccurrence | X | X | Gets a specific instance of an appointment for a specific date. |
Remarks
When you create a recurring appointment, the IRecurrencePattern object gets the StartTime, Duration, and EndTime values from the appointment, so you do not need to set them. If you do set these values, your settings override the appointment settings. If you set all three properties — StartTime, Duration, EndTime — Outlook Mobile ignores the Duration setting and defines the appointment with the StartTime and EndTime settings. If you set any two of these properties and leave the third undefined, Outlook Mobile calculates the undefined setting from the two properties you set.
To set the start date of an IRecurrencePattern object, use the PatternStartDate property. For Appointments, the Duration property of an IRecurrencePattern object cannot be longer than 31 days. Furthermore, the minimum period between instances of a recurring appointment cannot be less than the duration of the appointment. Otherwise, appointment instances would overlap.
Requirements
Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: pimstore.h
Library: pimstore.lib
See Also
How to: Create a Recurring Appointment | Pocket Outlook Object Model API Interfaces | Pocket Outlook Object Model API Enumerations
Send Feedback on this topic to the authors