SchedulerControl.AdditionalAppointmentsDrag Event
Occurs for the appointments added to the AppointmentDragEventArgs.AdditionalAppointments collection when they are dragged with the primary appointment.
Namespace: DevExpress.XtraScheduler
Assembly: DevExpress.XtraScheduler.v18.2.dll
Declaration
public event EventHandler<AdditionalAppointmentsDragEventArgs> AdditionalAppointmentsDragPublic Event AdditionalAppointmentsDrag As EventHandler(Of AdditionalAppointmentsDragEventArgs)Event Data
The AdditionalAppointmentsDrag event's data class is AdditionalAppointmentsDragEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| AdditionalAppointmentInfos | Provides access to the properties of the additional dragged appointments. |
| PrimaryAppointmentInfos | Provides access to the properties of the primary dragged appointments. |
Remarks
When an end-user drags an appointment, the SchedulerControl.AppointmentDrag event occurs for that appointment. Event data (the AppointmentDragEventArgs.AdditionalAppointments property) allows you to specify appointments which will be dragged with the primary appointment synchronously. When they are dragged, the AdditionalAppointmentsDrag event fires for each additional appointment. If an end-user presses ESC, both appointments return to the initial state.
Examples
NOTE
A complete sample project is available at https://github.com/DevExpress-Examples/how-to-add-an-appointment-to-the-dragged-appointment-in-a-drag-and-drop-operation-t445652
private void SchedulerControl_AppointmentDrag(object sender, AppointmentDragEventArgs e) {
// Find a special appointment among visible appointments.
AppointmentBaseCollection visbileApts = schedulerControl1.ActiveView.GetAppointments();
Appointment apt = visbileApts.Find(item => (item.Subject == "Finalize" && item.ResourceId.Equals(e.HitResource.Id)));
if (apt == null) {
e.AdditionalAppointments.Clear();
}
else {
if (e.SourceAppointment != apt) {
// If the dragged appointment overlaps with the special appointment,
// add the special appointment to the AdditionalAppointments collection
// to drag along with the initial appointment.
// The AdditionalAppointmentsDrag event will occur.
if (e.EditedAppointment.End > apt.Start)
e.AdditionalAppointments.Add(apt);
else
e.AdditionalAppointments.Clear();
}
}
}
private void SchedulerControl1_AdditionalAppointmentsDrag(object sender, AdditionalAppointmentsDragEventArgs e) {
if (e.AdditionalAppointmentInfos.Count <= 0)
return;
AppointmentDragInfo aptInfo = e.AdditionalAppointmentInfos[0];
// If the end of the main dragged appointment becomes greater than the start of the special appointment,
// set the start of the special appointment being dragged to the end of the main dragged appointment.
// It prevents overlapping appointments.
if (e.PrimaryAppointmentInfos[0].EditedAppointment.End > aptInfo.SourceAppointment.Start)
aptInfo.EditedAppointment.Start = e.PrimaryAppointmentInfos[0].EditedAppointment.End;
}