Events

This section describes events fired by this widget.

See Also

appointmentAdded

Raised after an appointment is added to the data source.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

appointmentData:

Object

The added appointment's data.

The standard Error object that defines the occurred error.

Main article: onAppointmentAdded

See Also

appointmentAdding

Raised before an appointment is added to the data source.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

appointmentData:

Object

The data of the appointment to be added.

cancel:

Boolean

|

Promise<Boolean> (jQuery or native)

Allows you to cancel appointment adding.
If you pass a Promise to this field, appointment adding is continued or canceled once the Promise has been resolved.

Main article: onAppointmentAdding

See Also

appointmentClick

Raised when an appointment is clicked or tapped.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

appointmentData:

Object

The initial appointment.

targetedAppointmentData:

Object

The clicked appointment.

appointmentElement:

Element (jQuery or HTML)

The clicked appointment's container. It is an HTML Element or a jQuery Element when you use jQuery.

jQueryEvent:

jQuery.Event

The jQuery event that caused the handler execution. Deprecated in favor of the event field.

event:

Event (jQuery or dxEvent)

The event that caused the handler execution. It is a dxEvent or a jQuery.Event when you use jQuery.

cancel:

Boolean

Allows you to cancel execution of the default appointment click handler.

Main article: onAppointmentClick

See Also

appointmentContextMenu

Raised when a user attempts to open the browser's context menu for an appointment.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if you use Knockout.

appointmentData:

Object

The initial appointment.

targetedAppointmentData:

Object

The appointment on which the context menu is invoked.
For details on the difference between this and the appointmentData fields, see the onAppointmentClick option description.

appointmentElement:

Element (jQuery or HTML)

The container of the appointment on which the context menu is invoked.
It is an HTML Element or a jQuery Element when you use jQuery.

jQueryEvent:

jQuery.Event

The jQuery event that caused the handler's execution. Deprecated in favor of the event field.

event:

Event (jQuery or dxEvent)

The event that caused the handler's execution. It is a dxEvent or a jQuery.Event when you use jQuery.

Main article: onAppointmentContextMenu

See Also

appointmentDblClick

Raised when an appointment is double-clicked or double-tapped.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

appointmentData:

Object

The initial appointment.

targetedAppointmentData:

Object

The clicked appointment.

appointmentElement:

Element (jQuery or HTML)

The clicked appointment's container. It is an HTML Element or a jQuery Element when you use jQuery.

jQueryEvent:

jQuery.Event

The jQuery event that caused the handler execution. Deprecated in favor of the event field.

event:

Event (jQuery or dxEvent)

The event that caused the handler execution. It is a dxEvent or a jQuery.Event when you use jQuery.

cancel:

Boolean

Allows you to cancel execution of the default appointment click handler.

Main article: onAppointmentDblClick

See Also

appointmentDeleted

Raised after an appointment is deleted from the data source.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

appointmentData:

Object

The deleted appointment's data.

The standard Error object that defines the occurred error.

Main article: onAppointmentDeleted

See Also

appointmentDeleting

Raised before an appointment is deleted from the data source.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

appointmentData:

Object

The data of the appointment to be deleted.

cancel:

Boolean

|

Promise<Boolean> (jQuery or native)

Allows you to prevent the appointment from being deleted.
If you pass a Promise to this field, appointment deleting is continued or canceled once the Promise has been resolved.

Main article: onAppointmentDeleting

See Also

appointmentFormCreated

Raised before an appointment's details form is opened.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if you use Knockout.

appointmentData:

Object

The data of the appointment for which a form is opened.

form:

Form

The form's instance.

Main article: onAppointmentFormCreated

See Also

appointmentRendered

Raised when an appointment is rendered.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

appointmentData:

Object

The initial appointment's data.

targetedAppointmentData:

Object

The current appointment's data.

appointmentElement:

Element (jQuery or HTML)

The appointment's container. It is an HTML Element or a jQuery Element when you use jQuery.

Main article: onAppointmentRendered

See Also

appointmentUpdated

Raised after an appointment is updated in the data source.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

appointmentData:

Object

The updated appointment's data.

The standard Error object that defines the occurred error.

Main article: onAppointmentUpdated

See Also

appointmentUpdating

Raised before an appointment is updated in the data source.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

oldData:

Object

The data of the appointment to be updated.

newData:

Object

The appointment with new data.

cancel:

Boolean

|

Promise<Boolean> (jQuery or native)

Allows you to prevent an appointment update.
If you pass a Promise to this field, the appointment updating is continued or canceled once the Promise has been resolved.

Main article: onAppointmentUpdating

See Also

cellClick

Raised when a view cell is clicked.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if Knockout is used.

cellData:

Object

The clicked cell's data.

cellElement:

Element (jQuery or HTML)

The clicked cell's container. It is an HTML Element or a jQuery Element when you use jQuery.

jQueryEvent:

jQuery.Event

The jQuery event that caused the handler execution. Deprecated in favor of the event field.

event:

Event (jQuery or dxEvent)

The event that caused the handler execution. It is a dxEvent or a jQuery.Event when you use jQuery.

cancel:

Boolean

Allows you to cancel execution of the default cell click handler.

Main article: onCellClick

See Also

cellContextMenu

Raised when a user attempts to open the browser's context menu for a cell.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if you use Knockout.

cellData:

Object

The data of the cell on which the context menu is invoked.

cellElement:

Element (jQuery or HTML)

The cell's container. It is an HTML Element or a jQuery Element when you use jQuery.

jQueryEvent:

jQuery.Event

The jQuery event that caused the handler's execution. Deprecated in favor of the event field.

event:

Event (jQuery or dxEvent)

The event that caused the handler's execution. It is a dxEvent or a jQuery.Event when you use jQuery.

Main article: onCellContextMenu

See Also

contentReady

Raised when the widget's content is ready.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only when using Knockout.

Main article: onContentReady.

See Also

disposing

Raised before the widget is disposed of.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if you use Knockout.

Main article: onDisposing

See Also

initialized

Raised only once, after the widget is initialized.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

Main article: onInitialized

See Also

optionChanged

Raised after a widget option is changed.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Scheduler

The widget's instance.

name:

String

The option's short name.

fullName:

String

The option's full name.

value: any

The option's new value.

element:

Element (jQuery or HTML)

The widget's container. It is an HTML Element or a jQuery Element when you use jQuery.

model:

Object

The model data. Available only if you use Knockout.

Main article: onOptionChanged

See Also