416.467.9100 | Dundas Data Visualization | Login
Welcome Guest
Dashboard v5.0

This site makes extensive use of JavaScript.

Please enable JavaScript in your web browser and reload the page before proceeding.

Chart - Interactions

Hide navigation
RSS
Modified on Fri, 01 Mar 2013 12:14 PM Categorized as Chart, Data Controls
Click to return to: Documentation | Designing Dashboards | DV Controls | Chart


Note: By default, data point labels are not used to determine the DashboardDataPoint provided as an argument in mouse interactions, so that they do not interfere with other data points below them. To access the data point associated with a data point label when the mouse is over it, set the Labels Interactive property of the series to True.

Interactions

Axis Updated

The Axis Updated interaction lets you respond to changes to the data displayed along an axis and its scales.

ImageThis is an Advanced property.

Tip: This interaction can also be set on an axis directly: use the Updated Interaction on the axis. On the chart, this interaction fires once for each axis on the chart that displays data that has changed, including both X and Y axes, so use the Axis property of e to check which axis is updating.

Arguments:


This interaction can be triggered by changes in the values of data points or the number of data points, and happens after a short delay to ensure that all data point changes are handled together efficiently. The following properties may have changed automatically when this interaction is triggered, which can be accessed in script:
The IsUpdatePending property of DashboardAxis can be used to determine if this interaction has yet to be triggered.

Chart Cursor User Changed

The Chart Cursor User Changed interaction lets you respond once the user has interactively changed the chart cursor using the mouse. This interaction is triggered when the mouse button is released.

ImageThis is an Advanced property.

Arguments:


Tip: The event arguments provided in this interaction provide the cursor start and end positions as values relative to the axes of the chart. To convert these axis positions to values, use the methods provided on DashboardAxis.

Chart Cursor User Changing

The Chart Cursor User Changing interaction lets you respond as the user interactively changes the chart cursor using the mouse. This interaction is triggered while the mouse button is pressed.

ImageThis is an Advanced property.

Arguments:


Tip: The event arguments provided in this interaction provide the cursor start and end positions as values relative to the axes of the chart. To convert these axis positions to values, use the methods provided on DashboardAxis.

Click

The Click interaction lets you respond to mouse clicks on the control.

Arguments:


The VisualElementArgs property of e is a DashboardDataPoint.

Context Click

The Context Click interaction lets you respond when the right mouse button is released.

Arguments:


The VisualElementArgs property of e is a DashboardDataPoint.

This interaction is also used to call up the context menu, so setting the Handled property of e to true prevents the context menu from appearing, otherwise the commands visible in the context menu can be customized using the ContextCommands property of e.

Hover

The Hover interaction lets you respond to the user “hovering” their mouse over the control.

Arguments:


The VisualElementArgs property of e is a DashboardDataPoint.

Mouse Enter

The Mouse Enter interaction lets you respond to the user moving the mouse into the control's area.

ImageThis is an Advanced property.

Arguments:


The VisualElementArgs property of e is a DashboardDataPoint.

Mouse Leave

The Mouse Leave interaction lets you respond to the user moving the mouse out of the control's area.

ImageThis is an Advanced property.

Arguments:


The VisualElementArgs property of e is a DashboardDataPoint.

Note: The Mouse Leave event occurs whenever the mouse is no longer directly over the control. For example, if you displayed a message (via the services.ShowMessage method) that appeared under the mouse, the Mouse Leave event would occur even though the mouse hasn't moved.

Mouse Move

The Mouse Move interaction lets you respond to mouse movements in the control's area.

ImageThis is an Advanced property.

Arguments:


The VisualElementArgs property of e is a DashboardDataPoint.

Mouse Right Down

The Mouse Right Button Down interaction lets you respond when the right mouse button is pressed on the control.

ImageThis is an Advanced property.

Arguments:


The VisualElementArgs property of e is a DashboardDataPoint.

Mouse Up

The Mouse Up interaction lets you respond when the left mouse button is released on the control.

ImageThis is an Advanced property.

Arguments:


The VisualElementArgs property of e is a DashboardDataPoint.

On Data Changed

The On Data Changed interaction lets you respond to changes in the control's underlying data.

These interactions run when the data changes in this data visualization control. This could be from a parameter change, or a real-time update. The real-time updates will cause this interaction to fire on the timer, regardless of whether the actual data changed.

Tip: On Data Changed happens only once per update, not once per changed data point. It will also happen if the values did not change.

ImageThis is an Advanced property.

Arguments:


On Layout Updated

The On Layout Updated interaction lets you respond when the layout is updated in the control.

This interaction fires in the same scenarios as the On Data Changed interaction with the exception that it is fired after the control has processed the updated data.

ImageThis is an Advanced property.

Arguments:


Viewport User Changed

The Viewport User Changed interaction lets you respond to the user's interactive changes to the chart's viewport by zooming or scrolling.

ImageThis is an Advanced property.

Arguments:


Tip: The event arguments provided in this interaction provide the position and size of the viewport as values relative to the axes of the chart. To convert these axis positions to values, use the methods provided on DashboardAxis.

Related topics


Click to return to: Documentation | Designing Dashboards | DV Controls | Chart

About Dundas | Contact Us Follow us on Twitter! | Privacy Statement | Report Site Issues

Copyright © 2009-2014 Dundas Data Visualization, Inc.