Appointment
- 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.
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.GetAppointments | |
| 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. |