A newer version of this page is available. Switch to the current version.


  • 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.

Organizing Appointments

Appointments can be grouped by label and status. To extend appointment classification and enable tracking by different criteria, you can store additional information in appointment's custom fields.

Member Table

Member Description
AppointmentItem An appointment in the Scheduler.
SchedulerControl.AppointmentItems Provides access to the appointments in the scheduler.
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.