Appointments

Nov 29, 2021
2 minutes to read

Overview

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.