Skip to main content


  • 2 minutes to read


An appointment is an activity scheduled for a specific time interval. An activity is characterized by its subject, location, category (Label), status (Status) and description. An appointment may also contain custom properties. Appointments can be recurring, which means that an activity can be scheduled to repeat at specified time intervals.

The scheduler displays an appointment as a color rectangle with text and graphics elements, as illustrated in the picture below.


An AppointmentItem object represents an appointment, and the the active View, which is used to show the Scheduler’s data, determines its visual representation.

Appointment Types

Appointments are of several types, indicated by the AppointmentItem.Type property. A regular appointment type is AppointmentType.Normal. All appointment types are listed in the AppointmentType enumeration.

The following diagram illustrates the difference between recurring and non-recurring appointment types.


To learn more about recurring appointments and their types, see the Recurrence document.

Data Binding

Appointments can be stored in the data source. To use them in a scheduler, bind a data source to the DataSource.AppointmentsSource property and specify the DataSource.AppointmentMappings. The DataSource.AppointmentMappings property can be set to either a collection of resource IDs or a string in the XML format.

Member Table

Member Description
AppointmentItem An appointment in the Scheduler.
SchedulerControl.AppointmentItems Provides access to the appointments in the scheduler.
SchedulerControl.GetAppointments Returns the collection of appointments for the specified time interval.
SchedulerControl.SelectedAppointments Provides access to the selected appointments.
SchedulerControl.InitNewAppointment Occurs before a new AppointmentItem is created in the SchedulerControl.
SchedulerControl.AppointmentsUpdated Occurs after Scheduler appointments are updated.
SchedulerControl.GetAppointmentItemBySourceObject Gets a source object’s associated appointment.
SchedulerControl.SelectedAppointmentsSource Gets or sets the object used as the selected appointments’ source. This is a dependency property.
See Also