Programmer's Guide:
Using Calendars

A calendar is an eRoom item in which you schedule individual and team events.

A Calendar Page object manages an eRoom calendar on its own page. To create a Calendar Page, use the CreateCalendarPage method in the IERUContainer interface of any container object.Calendar Pages offer basic containment capabilities through the IERUContainer interface, as well as basic information through the properties Name, ID, Creator, CreateDate, Modifier, and ModifyDate properties of the IERUItem interface. Calendar Pages also implement the following calendaring-specific interfaces:

• IERUCalendar, which provides methods for creating one-time and repeating events, finding events whose titles contain specific keywords, and getting a collection of IERUItem interface pointers to all the events a Calendar Page contains.

• IERUCalendarPage, which provides properties that let you work with the Calendar Page. Use the Description property to get or set the rich text description of the folder. Use ShowTopic to indicate whether the embedded topic is displayed in the user interface.

Calendar Events

A calendar event provides details about a particular occasion, including if it is a one-time or repeating event. A Calendar Event object manages a one-time event or a all the occurrences of a repeating event. Events are also items, and so can be manipulated with all the methods and properties of the IERUItem and IERUCalendarEventPage interfaces. IERUCalendarRecurringEvent lets you work with repeating events. Setting properties on repeating events through IERUCalendarRecurringEvent affects each occurrence of the event.

Setting a Recurrence Pattern

Use the RecurrencePattern and Days properties to set the recurrence pattern for a repeating event. The following table lists examples of recurrence patterns and describes the appropriate values for RecurrencePattern and Days for each example.