windowsforms-2880-controls-and-libraries-scheduler-examples-forms-how-to-create-a-custom-appointment-recurrence-form-method-1.md
This document explains how to customize the dialog that allows users to modify recurrence settings.
The default Appointment Recurrence form contains the “Daily”, “Weekly”, “Monthly” and “Yearly” pattern options.
The “Minutely” and “Hourly” patterns are hidden initially. Use the SchedulerOptionsCustomization.RecurrenceFormEditors property to choose which pattern options should be available to users.
schedulerControl1.OptionsCustomization.RecurrenceFormEditors =
RecurrenceFormEditors.Minutely | RecurrenceFormEditors.Hourly | RecurrenceFormEditors.Daily;
schedulerControl1.OptionsCustomization.RecurrenceFormEditors =
RecurrenceFormEditors.Minutely Or RecurrenceFormEditors.Hourly Or RecurrenceFormEditors.Daily
In v19.1 and older, you can create an AppointmentRecurrenceForm descendant and handle the SchedulerControl.EditAppointmentFormShowing event to replace a default form with this custom form.
void schedulerControl1_EditAppointmentFormShowing(object sender, DevExpress.XtraScheduler.AppointmentFormEventArgs e)
{
// The recurrence form allows you to edit only daily recurring appointments.
using(var myForm = new MyAppointmentEditForm(schedulerControl1,
e.Appointment, e.OpenRecurrenceForm, DevExpress.XtraScheduler.RecurrenceType.Daily))
myForm.ShowDialog();
e.Handled = true;
}
Private Sub schedulerControl1_EditAppointmentFormShowing(ByVal sender As Object, ByVal e As DevExpress.XtraScheduler.AppointmentFormEventArgs)
' The recurrence form allows you to edit only daily recurring appointments.
Using myForm = New MyAppointmentEditForm(schedulerControl1, e.Appointment, e.OpenRecurrenceForm, DevExpress.XtraScheduler.RecurrenceType.Daily)
myForm.ShowDialog()
End Using
e.Handled = True
End Sub
See this GitHub example for a complete sample.
In v19.1 and older, Appointment Recurrence Form editors were placed directly on the form’s surface. Starting with v19.2, the form uses the LayoutControl to arrange its editors. The Layout Control ensures that the form has a correct layout when shown on HiDPI devices.
Due to this change, you cannot create custom AppointmentRecurrenceForm descendants and use them in v19.2 and newer. If you upgrade to v19.2 and want to use your custom forms, change your custom forms’ base class from AppointmentRecurrenceForm to LegacyAppointmentRecurrenceForm.
//v19.1 and older
public class MyAppointmentRecurrenceForm : AppointmentRecurrenceForm {
//...
}
//v19.2 and newer
public class MyAppointmentRecurrenceForm : LegacyAppointmentRecurrenceForm {
//...
}
'v19.1 and older
Public Class MyAppointmentRecurrenceForm
Inherits AppointmentRecurrenceForm
'...
End Class
'v19.2 and newer
Public Class MyAppointmentRecurrenceForm
Inherits LegacyAppointmentRecurrenceForm
'...
End Class