SchedulerControl.AppointmentDrop Event

Occurs when an appointment is dropped onto the Scheduler control.

Namespace: DevExpress.Xpf.Scheduler

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

Declaration

C#

public event AppointmentDragEventHandler AppointmentDrop

VB.NET

Public Event AppointmentDrop As AppointmentDragEventHandler

Event Data

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

Property	Description
AdditionalAppointments	Provides access to the collection of the additional dragged appointments.
Allow	Specifies whether the appointment can be dragged along the time cells.
CopyEffect	Indicates whether the drop effect in a drag-and-drop appointment operation is Copy.
EditedAppointment	Gets the appointment being modified in the drag-and-drop event.
ForceUpdateFromStorage	Gets or sets whether the View is forced to query appointments from the storage.
HitInterval	Gets the time interval represented by the time cell to which an appointment was dragged.
HitResource	Gets the resource to which an appointment was dragged.
NewAppointmentResourceIds	Gets or sets the IDs of resources for a new appointment.
SourceAppointment	Gets the source appointment in the drag-and-drop event.

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.

Use the AppointmentDrop event to manage, with the drag-and-drop action, appointments within the Scheduler control. Information, which is provided by the event’s argument properties, allows you to deny, cancel or handle specifically the event.

For instance, you have access to the appointment before dragging (the AppointmentDragEventArgs.SourceAppointment property), to the time interval where the appointment was dropped (the AppointmentDragEventArgs.HitInterval property), the resource associated with a new appointment location (the AppointmentDragEventArgs.HitResource property). The AppointmentDragEventArgs.NewAppointmentResourceIds property can be used for assignment of resources to a relocated appointment.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AppointmentDrop 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-implement-precise-drag-and-drop-and-resizing-of-appointments-in-day-view-work-week-t408165/CS/MainWindow.xaml#L17

<dxsch:SchedulerControl Name="schedulerControl1" ActiveViewType="Month"
                        AppointmentDrop="schedulerControl1_AppointmentDrop" PreviewMouseDown="schedulerControl1_PreviewMouseDown" />

how-to-implement-drag-and-drop-between-a-legacy-scheduler-and-a-grid-e3808/CS/MainWindow.xaml#L16

<!-- SchedulerControl -->
<dxsch:SchedulerControl Name="schedulerControl1" AppointmentDrop="schedulerControl1_AppointmentDrop" PreviewMouseDown="schedulerControl1_PreviewMouseDown" />

VB.NET

how-to-implement-precise-drag-and-drop-and-resizing-of-appointments-in-day-view-work-week-t408165/VB/CustomHandlers/AppointmentsDragHelper.vb#L34

AddHandler control.MouseDown, AddressOf MouseDownHandler
AddHandler control.AppointmentDrop, AddressOf AppointmentDropHandler
AddHandler control.AppointmentDrag, AddressOf AppointmentDragHandler