Appointments
- 3 minutes to read
The Appointment is visually represented as a rectangle laying on the time cells of the scheduler area. The time cells it occupies correspond to its scheduled time interval. If an appointment is scheduled for a whole day (Appointment.AllDay), or extends from one day to another, it is displayed in the All-Day Area of the Scheduler control.
The following screenshot illustrates appointemnt’s visual elements:
Tip
Use the AppointmentDisplayOptions property of Scheduler Views to customize display settings of appointments. This property is overriden by Scheduler Views to introduce view-specific settings (e.g., WeekView.AppointmentDisplayOptions).
The following table lists general settings that affect the visual appearance and behavior of appointments:
| Visual Element | Property |
|---|---|
| Height | AppointmentDisplayOptions.AppointmentHeight. This property specifies the height of the rectange that represents an appointment, unless the AppointmentDisplayOptions.AppointmentAutoHeight property is set to true. For the Day View or Work Week View view types the appointment height depends on its duration when an appointment does not occupy the whole day. So the AppointmentHeight and AppointmentAutoHeight property is applicable only to the Appointment.AllDay type appointments in those views. |
| Start time | Appointment.Start. The start of the scheduled time. If the Appointment.AllDay property is set to true, the start date of the appointment is the System.DateTime.Date of the Appointment.Start, and the start time of the appointment is 0:00. To hide the start time, use the AppointmentDisplayOptions.StartTimeVisibility property. The start and end time values can be displayed using a clock face instead of numbers - specify the AppointmentDisplayOptions.TimeDisplayType property as needed. |
| End time | Appointment.End. The end of the scheduled time. To hide the end time, use the AppointmentDisplayOptions.EndTimeVisibility property. The start and end time values can be displayed using a clock face instead of numbers - specify the AppointmentDisplayOptions.TimeDisplayType property as needed. |
| Subject | Appointment.Subject. A string that briefly characterizes the appointment. |
| Location | Appointment.Location. A string that identifies the place for the scheduled event. When displayed, it is automatically enclosed in parentheses. |
| Description | Appointment.Description. A block of text that provides the additional information about an appointment. |
| Reminder sign | Appointment.HasReminder. Indicates that the appointment has an assigned reminder to provide a notification before the scheduled time occurs. Set this property to true to add the default Reminder to the appointment. To hide the reminder sign use the AppointmentDisplayOptions.ShowReminder property. |
| Recurrence | Appointment.IsRecurring. If this property’s value is true, then an appointment has an associated recurring pattern. (for more information refer to the Recurring Appointments and Exceptions topic). When the appointment’s start or end time has been arbitrarily changed, the appointment does not conform to its recurrence pattern and it is indicated by the crossed recurrence sign. To hide the sign use the AppointmentDisplayOptions.ShowRecurrence property. |
| Status | AppointmentDisplayOptions.StatusDisplayType. It may display the time status by its color, or the appointment’s duration by the span of the colorized part along the time ruler (available for the Week View and Month View). The status element may also be hidden. |
| Snapping Mode | AppointmentDisplayOptions.SnapToCellsMode |
See Also