ASPxClientScheduler.AppointmentDrag Event

A client-side event that occurs when an appointment is being dragged.

Declaration

AppointmentDrag: ASPxClientEvent<AppointmentDragEventHandler<ASPxClientScheduler>>

Event Data

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

Property	Description
allow	Specifies whether or not appointments can be dropped into the intervals over which they are currently dragged.
dragInformation	Provides information about dragged appointments.
mouseEvent	Gets a mouse event object related to the current drag operation.

Example

In this example, the ASPxClientScheduler.AppointmentDrag is handled to disable dragging appointments with the “Completed” status. In the ASPxScheduler.InitClientAppointment event handler, custom field values (that store additional information about appointments) are passed to the client appointments so that these fields values can be analyzed on the client side.

C#

protected void ASPxScheduler1_InitClientAppointment(object sender, InitClientAppointmentEventArgs args) {
    args.Properties.Add("cpCompleted", args.Appointment.CustomFields["LessonCompleted"]);
    args.Properties.Add("cpCustomRecurringFlag", args.Appointment.CustomFields["CustomRecurringFlag"]);
    args.Properties.Add("cpCustomRecurringID", args.Appointment.CustomFields["CustomRecurringID"]);
}

JS

function OnAppointmentDrag(s, e) {
for (var i = 0; i < e.dragInformation.length; i++) {
    var currentAppointment = s.GetAppointmentById(e.dragInformation[0].appointmentId);
    if (currentAppointment.cpCompleted) {
        e.allow = false;
        break;
    }
}
}

ASPX

<Appointments AutoRetrieveId="True" ResourceSharing="false">
...
    <CustomFieldMappings>
        <dxwschs:ASPxAppointmentCustomFieldMapping Member="Completed" Name="LessonCompleted" ValueType="Boolean" />
        <dxwschs:ASPxAppointmentCustomFieldMapping Member="CustomIsRecurring" Name="CustomRecurringFlag" ValueType="Boolean" />
        <dxwschs:ASPxAppointmentCustomFieldMapping Member="CustomRecurringID" Name="CustomRecurringID" ValueType="String" />
        <dxwschs:ASPxAppointmentCustomFieldMapping Member="CreatedBy" Name="ApptCreatedBy" ValueType="String" />
        <dxwschs:ASPxAppointmentCustomFieldMapping Member="ModifiedBy" Name="ApptModifiedBy" ValueType="String" />
        <dxwschs:ASPxAppointmentCustomFieldMapping Member="CreatedDate" Name="ApptCreatedDate" ValueType="DateTime" />
        <dxwschs:ASPxAppointmentCustomFieldMapping Member="ModifiedDate" Name="ApptModifiedDate" ValueType="DateTime" />
    </CustomFieldMappings>
</Appointments>