A control that uses a table to display cells as days in a calendar layout. Use the Calendar control to display a list of calendar events in a calendar table.

The calendar format uses the displayUnits property to set the arrangement of days as a full calendar month, a single week, or a single day. Setting the rows property specifies the number of displayed calendar units at one time. For example, specifying displayUnits to units of days, and setting the rows property to 3, displays a three-day horizontal span of days. If a paging control is attached to the calendar, it moves forward or back three days at a time.

The Calendar control displays days, weeks, and months based on a range of items that use a zero-based index. To use a zero-based index, you must define the calendar's calendarStartDate property.

When a calendarStartDate is not specified, the default value is calculated using the current displayUnits. For example, if the displayUnits property is set to week, the default start date is set to the week prior to the current week. The user cannot page back to before the calendar's calendarStartDate.

The calendarEndDate property specifies the last date the user can view in the calendar. An undefined calendarEndDate indicates an open-ended range.

The events displayed in the Calendar control are provided by binding the events property to an ICalendarEventProvider, which exposes a list of objects that implement the ICalendarEvent interface. You can use an actual ICalendarEventProvider, which is a list containing ICalendarEvent objects, or an array of ICalendarEvents.

The Calendar control separates events into two categories:

• Multi-day events lasting longer than one day or spanning midnight into the next day.

  The Calendar control renders Multi-day events horizontally and occupy a single row in the calendar.

• Sub-day event which represent a portion of the day

  The Calendar control renders Sub-day events as items stacked vertically in a day's cell.

The calendar contents display in the header and event facets. The header facet is a set of controls that draws the calendar header and can contain a set of text controls that display the range of dates displayed. The event facet contains a set of controls that draw each event in the calendar. Using the event facet, you to specify how to render the event drawn.

The facet controls can bind to any expression. However, the calendar exposes three scope variables that represent the current item being drawn. The properties exposed by these variables are visible in the Bindings View:

• Unit--A CalendarUnit object exposing information about the currently displayed unit (month, week, day). This variable is useful when drawing the calendar header.
• Day--An ICalendarDay object exposing information about the current day being drawn. The variable contains a single Date.
• Event--The ICalendarEvent object currently in rendering process. Although any object can use the ICalendarEvent object, the interface exposes the event Start/Stop date, event type, header, and body for use in the event facet controls.