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