Custom Fields and Appointment Form

26 Mon
27 Tue
28 Wed
29 Thu
30 Fri
8 8:00 00
9 9:00 00
10 10:00 00
11 11:00 00
12 12 PM PM
1 1:00 00
2 2:00 00
3 3:00 00
4 4:00 00
5 5:00 00
6 6:00 00

The DevExpress Blazor Scheduler allows you to add custom properties to appointments, labels, and status items. To create these custom elements, define custom fields in source objects and add them to the CustomFieldMappings collection. In this demo, an appointment's source object includes an Accepted custom field that is mapped to the IsAccepted appointment property. The property value is used in the HorizontalAppointmentTemplate and VerticalAppointmentTemplate to change appointment appearance.

The Scheduler also allows you to customize the appointment edit form as needed. Use the following properties to construct your custom form layout:

  • AppointmentFormLayout - the layout of the pop-up form that appears when you create an appointment and click the expand button or when you edit an appointment.
  • AppointmentCompactFormLayout - the layout of the compact form that appears when you create an appointment.

The Scheduler ships with a set of predefined form layout items (DxSchedulerSubjectFormLayoutItem, DxSchedulerStartDateFormLayoutItem, DxSchedulerStartTimeFormLayoutItem, etc). You can also add a custom item (DxSchedulerCustomFormLayoutItem ) and define its Template property. In this demo, custom layout items are used to display the IsAccepted property's editor and its validation summary.

To pass information about custom properties to the edit form, implement a custom descendant from the SchedulerAppointmentFormInfo class and assign it in the AppointmentFormShowing event handler.

To enable form validation, mark appointment properties in your custom class with annotation attributes and set the Scheduler's ValidateEditForm property to true.

You can also specify which appointment form users can use to create and edit appointments: the compact form, the pop-up form, or both. To do this, use the AppointmentFormMode property.