SchedulerControl.AppointmentResizing Event

Occurs when the user starts modifying the appointment's interval by dragging its border with the mouse.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v20.1.dll

Declaration

public event AppointmentResizeEventHandler AppointmentResizing
Public Event AppointmentResizing As AppointmentResizeEventHandler

Event Data

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

Property Description
Allow Specifies whether the appointment can be resized.
EditedAppointment Gets the appointment being edited in the resize event.
Handled Gets or sets whether the resize operation is handled, and therefore no default processing is required.
HitInterval Gets the time interval represented by the time cell to which the appointment's side is moved.
HitResource Gets the resource assigned to cells to which an appointment's side is moved.
ResizedSide Indicates which appointment side is being moved when the appointment is resized.
SourceAppointment Gets the source appointment in the resize event.

Remarks

The event arguments provide information on an appointment before and after resizing, the resource and time interval associated with time cells to which the appointment's edge is moving, and also indicate which side of the appointment is moved.

By setting the AppointmentResizeEventArgs.Allow property value to false and the AppointmentResizeEventArgs.Handled property - to true, you can cancel resizing.

The AppointmentResizing event determines the values of the Allow and Handled parameters passed to the SchedulerControl.AppointmentResized event which follows the AppointmentResizing event, as described in the table below.

AppointmentResizing Event AppointmentResized Event Effect
Set AppointmentResizeEventArgs.Allow = false, AppointmentResizeEventArgs.Handled = true. When the event occurs, its handler receives the AppointmentResizeEventArgs.Allow equals to false, the AppointmentResizeEventArgs.Handled equals to true. Resize action is canceled.
Set the AppointmentResizeEventArgs.Handled = false. When the event occurs, its handler receives the AppointmentResizeEventArgs.Allow and the AppointmentResizeEventArgs.Handled property values which are not determined by the AppointmentResizing event handler. Depends on the AppointmentResized event handler.

Therefore, if you want to cancel resizing, you can handle the AppointmentResizing event only.

The SchedulerOptionsCustomization.AllowAppointmentResize value takes priority over the AppointmentResizing. If it is set to AppointmentConflictsMode.Custom, then the SchedulerControl.AllowAppointmentResize event occurs before the AppointmentResizing event. Dragging the appointments border with the mouse results in a series of AppointmentResizing events, followed by a single SchedulerControl.AppointmentResized event.

See Also