SchedulerControl.RecurrenceFormShowing Event

Occurs before the Appointment Recurrence form is invoked.

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v18.2.dll

Declaration

C#

public event RecurrenceFormEventHandler RecurrenceFormShowing

VB.NET

Public Event RecurrenceFormShowing As RecurrenceFormEventHandler

Event Data

The RecurrenceFormShowing event's data class is RecurrenceFormEventArgs. The following properties provide information specific to this event:

Property	Description
AllowResize	Gets or sets a value indicating whether end-users are allowed to resize the form. Inherited from FormShowingEventArgs.
AppointmentFormViewModel	Gets the View Model for the appointment editing form from which the Appointment Recurrence dialog is invoked.
Cancel	Gets or sets the value indicating whether to cancel invoking the form. Inherited from FormShowingEventArgs.
Controller	Gets or sets the controller providing settings which are required to edit appointment recurrence in the Appointment Recurrence form.
Form	Gets or sets the form which will be invoked. Inherited from FormShowingEventArgs.
ParentForm	Gets the appointment editing form from which the Appointment Recurrence form is invoked.
SizeToContent	Obsolete. This property is obsolete. Inherited from FormShowingEventArgs.
ViewModel	Gets or sets the View Model for the form which will be invoked. Inherited from FormShowingEventArgs.

Remarks

Important

You are viewing documentation for the legacy WPF Scheduler control. If you’re starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

Handle the RecurrenceFormShowing event to perform any actions before the Appointment Recurrence form is shown. For instance, a custom form can be substituted in place of the standard one (the FormShowingEventArgs.Form property). If you use your own custom Edit Appointment form and it is required to invoke the default Appointment Recurrence dialog from this form, handle the RecurrenceFormShowing event and set the RecurrenceFormEventArgs.Controller property to the appointment editing form’s controller.

The Appointment Recurrence form can be invoked either by an end-user or via the SchedulerControl.ShowRecurrenceForm method.

Example

This example demonstrates how to replace the standard Appointment Recurrence form with a custom one via the SchedulerControl.RecurrenceFormShowing event.

Set the FormShowingEventArgs.Form property to the instance of a class specifying the custom recurrence form with the passed AppointmentFormController controller of the Edit Appointment form (RecurrenceFormEventArgs.ParentForm) from which the Appointment Recurrence form is invoked.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-a-custom-appointment-recurrence-form-e3797.

MainWindow.xaml

<dxsch:SchedulerControl Name="schedulerControl1" 
                        HorizontalAlignment="Stretch" VerticalAlignment="Stretch" 
                        ActiveViewType="Week"
                        GroupType="Resource"
                        RecurrenceFormShowing="schedulerControl1_RecurrenceFormShowing">

MainWindow.xaml.vb

Private Sub schedulerControl1_RecurrenceFormShowing(sender As Object, _
                                                    e As RecurrenceFormEventArgs)
    Dim appointmentForm As AppointmentForm = TryCast(e.ParentForm, AppointmentForm)
    e.Form = New CustomRecurrenceForm(appointmentForm.Controller)
End Sub

MainWindow.xaml.cs

private void schedulerControl1_RecurrenceFormShowing(object sender, RecurrenceFormEventArgs e) {
    AppointmentForm appointmentForm = e.ParentForm as AppointmentForm;
    e.Form = new CustomRecurrenceForm(appointmentForm.Controller);
}

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the RecurrenceFormShowing event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-a-custom-appointment-recurrence-form-e3797/CS/WpfApplication1/MainWindow.xaml#L12

                        GroupType="Resource"
                        RecurrenceFormShowing="schedulerControl1_RecurrenceFormShowing">
<!--endregion #SchedulerControlPropertiesEvents-->

how-to-invoke-the-default-appointment-recurrence-dialog-from-a-custom-edit-appointment-form-e3796/VB/WpfApplication1/MainWindow.xaml#L13

EditAppointmentFormShowing="schedulerControl1_EditAppointmentFormShowing"
RecurrenceFormShowing="schedulerControl1_RecurrenceFormShowing">