SchedulerControl.EditAppointmentFormShowing Event

Occurs before the Edit Appointment form is invoked.

Namespace: DevExpress.Xpf.Scheduler

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

Declaration

C#

public event AppointmentFormEventHandler EditAppointmentFormShowing

VB.NET

Public Event EditAppointmentFormShowing As AppointmentFormEventHandler

Event Data

The EditAppointmentFormShowing event's handler receives an argument of the EditAppointmentFormEventArgs type. 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.
Appointment	Gets the appointment for which the form showing event has been raised.
Cancel	Gets or sets the value indicating whether to cancel invoking the form. Inherited from FormShowingEventArgs.
Form	Gets or sets the form to be invoked. Inherited from FormShowingEventArgs.
OpenRecurrenceDialog	Gets the value indicating whether the Appointment Recurrence form is displayed on the top of the Edit Appointment form.
SizeToContent	Obsolete. This API is obsolete now. Inherited from FormShowingEventArgs.
ViewModel	Gets or sets the View Model for the form which will be invoked. Inherited from FormShowingEventArgs.

Remarks

Handle the EditAppointmentFormShowing event to perform any actions before the Edit Appointment form is shown. You can replace the default form with a custom form, containing custom fields for editing additional appointment information.

This form can be invoked either by an end-user, or via the SchedulerControl.ShowEditAppointmentForm method. The EditAppointmentFormEventArgs.Appointment property contains an appointment which will be edited in this form.

The code snippet below illustrates how to handle the EditAppointmentFormShowing event. For more information on how to create and use a custom appointment form, refer to the Lesson 3 - Create a Custom Edit Appointment Form with Custom Fields document.

This example demonstrates how to replace the standard Edit Appointment form with a custom one, and prevent end-users from resizing this form via the SchedulerControl.EditAppointmentFormShowing event.

C#

using DevExpress.Xpf.Scheduler;
// ...

private void schedulerControl1_EditAppointmentFormShowing(object sender, EditAppointmentFormEventArgs e) {
    e.Form = new CustomAppointmentForm(this.schedulerControl1, e.Appointment);
    e.AllowResize = false;
}

VB.NET

Imports DevExpress.Xpf.Scheduler
' ...

Private Sub schedulerControl1_EditAppointmentFormShowing(ByVal sender As Object, _
ByVal e As EditAppointmentFormEventArgs)
    e.Form = New CustomAppointmentForm(Me.schedulerControl1, e.Appointment)
    e.AllowResize = False
End Sub

XAML

<dxsch:SchedulerControl Name="schedulerControl1" 
                        EditAppointmentFormShowing="schedulerControl1_EditAppointmentFormShowing"/>