Events

This section describes events fired by this widget.

See Also

argumentAxisClick

Raised when a label on the argument axis is clicked or tapped.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
argument:

Date

|

Number

|

String

The clicked label's value.

component:

Chart

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.

event:

Event (jQuery or dxEvent)

The event that caused the function to execute. It is a dxEvent or a jQuery.Event when you use jQuery.

jQueryEvent:

jQuery.Event

Use 'event' instead.

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

model:

Object

The model data. Available only if you use Knockout.

Cannot be used in themes.

Main article: onArgumentAxisClick

See Also

disposing

Raised before the widget is disposed of.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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

done

Raised when all series are ready.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

Cannot be used in themes.

Main article: onDone

See Also

drawn

Raised when the widget's rendering has finished.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

Cannot be used in themes.

Main article: onDrawn

See Also

exported

Raised after the widget is exported.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

Main article: onExported

See Also

exporting

Raised before the widget is exported.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
cancel:

Boolean

Allows you to prevent exporting.

component:

Chart

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.

fileName:

String

The name of the file to which the widget is about to be exported.

format:

String

The resulting file format. One of PNG, PDF, JPEG, SVG and GIF.

model:

Object

The model data. Available only if you use Knockout.

Main article: onExporting

See Also

fileSaving

Raised before a file with exported widget is saved to the user's local storage.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
cancel:

Boolean

Allows you to prevent file saving.

component:

Chart

The widget's instance.

data:

BLOB

Exported data as a BLOB.

element:

Element (jQuery or HTML)

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

fileName:

String

The name of the file to be saved.

format:

String

The format of the file to be saved.
Possible Values: 'PNG' | 'PDF' | 'JPEG' | 'SVG' | 'GIF'

Main article: onFileSaving

See Also

incidentOccurred

Raised when an error or warning occurs.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

target: any

Information on the occurred incident.

Main article: onIncidentOccurred

See Also

initialized

Raised only once, after the widget is initialized.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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

legendClick

Raised when a legend item is clicked or tapped.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

event:

Event (jQuery or dxEvent)

The event that caused the function to execute. It is a dxEvent or a jQuery.Event when you use jQuery.

jQueryEvent:

jQuery.Event

Use 'event' instead.

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

model:

Object

The model data. Available only if you use Knockout.

target:

Series

The series that corresponds to the clicked legend item; described in the Series section.

Cannot be used in themes.

Main article: onLegendClick

See Also

optionChanged

Raised after a widget option is changed.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

The widget's instance.

fullName:

String

The path to the modified option that includes all parent options.

name:

String

The modified option if it belongs to the first level. Otherwise, the first-level option it is nested into.

value: any

The modified 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

pointClick

Raised when a series point is clicked or tapped.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

event:

Event (jQuery or dxEvent)

The event that caused the function to execute. It is a dxEvent or a jQuery.Event when you use jQuery.

jQueryEvent:

jQuery.Event

Use 'event' instead.

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

model:

Object

The model data. Available only if you use Knockout.

target:

Point

The clicked series point; described in the Point section.

Cannot be used in themes.

Main article: onPointClick

See Also

pointHoverChanged

Raised after the pointer enters or leaves a series point.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Object

The widget's instance.

element:

Object

The widget's container.

target:

Point

The series point whose hover state has been changed; described in the Point section.

Cannot be used in themes.

Main article: onPointHoverChanged

See Also

pointSelectionChanged

Raised when a series point is selected or selection is canceled.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Object

The widget's instance.

element:

Object

The widget's container.

target:

Point

The series point whose selection state has been changed; described in the Point section.

Cannot be used in themes.

Main article: onPointSelectionChanged

See Also

seriesClick

Raised when a series is clicked or tapped.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

event:

Event (jQuery or dxEvent)

The event that caused the function to execute. It is a dxEvent or a jQuery.Event when you use jQuery.

jQueryEvent:

jQuery.Event

Use 'event' instead.

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

model:

Object

The model data. Available only if you use Knockout.

target:

Series

The clicked series.

Cannot be used in themes.

Main article: onSeriesClick

See Also

seriesHoverChanged

Raised after the pointer enters or leaves a series.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

target:

Series

The series whose hover state has been changed.

Cannot be used in themes.

Main article: onSeriesHoverChanged

See Also

seriesSelectionChanged

Raised when a series is selected or selection is canceled.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

target:

Series

The series whose selection state has been changed.

Cannot be used in themes.

Main article: onSeriesSelectionChanged

See Also

tooltipHidden

Raised when a tooltip becomes hidden.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

target:

Point

|

Chart Annotation

| any

The series point whose tooltip is hidden; described in the Point section.

Cannot be used in themes.

Main article: onTooltipHidden

See Also

tooltipShown

Raised when a tooltip appears.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
component:

Chart

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.

target:

Point

|

Chart Annotation

| any

The series point whose tooltip is shown; described in the Point section.

Cannot be used in themes.

Main article: onTooltipShown

See Also

zoomEnd

Raised when zooming or panning ends.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
actionType: 'zoom' | 'pan'

Indicates whether the user has zoomed or panned the chart.

axis:

Chart Axis

The zoomed/panned axis.

cancel:

Boolean

Allows you to cancel zooming or panning.

component:

Chart

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.

event:

Event (jQuery or dxEvent)

The event that caused the function to execute. It is a dxEvent or a jQuery.Event when you use jQuery.

model:

Object

The model data. Available only if you use Knockout.

previousRange:

Object

The visual range when zooming or panning starts.

range:

Object

The visual range when zooming or panning ends.

rangeEnd:

Date

|

Number

Use 'range' instead.

The argument axis' end value after zooming or panning. Deprecated in favor of the range field.

rangeStart:

Date

|

Number

Use 'range' instead.

The argument axis' start value after zooming or panning. Deprecated in favor of the range field.

shift:

Number

The visual range's shift from the previous position, measured in numeric values or milliseconds (for date-time axes).
Positive values indicate a shift towards greater axis values; negative values indicate a shift in the opposite direction.

zoomFactor:

Number

The zoom factor.

Cannot be used in themes.

Main article: onZoomEnd

See Also

zoomStart

Raised when zooming or panning begins.

Type:

Event

Function parameters:
e:

Object

Information about the event.

Object structure:
actionType: 'zoom' | 'pan'

Indicates whether the user is zooming or panning the chart.

axis:

Chart Axis

The zoomed/panned axis.

cancel:

Boolean

Allows you to cancel zooming or panning.

component:

Chart

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.

event:

Event (jQuery or dxEvent)

The event that caused the function to execute. It is a dxEvent or a jQuery.Event when you use jQuery.

model:

Object

The model data. Available only if you use Knockout.

range:

Object

The visual range when zooming or panning starts.

Cannot be used in themes.

Main article: onZoomStart

See Also