Custom Interactivity in the WinForms Dashboard

• Sep 30, 2022
• 2 minutes to read

You can implement custom interactivity for data-bound dashboard items along with built-in interactivity such as master filter and drill-down.

Dashboard Item Interactivity

You can use the DashboardDesigner.DashboardItemVisualInteractivity event to create element selection and highlighting for the following data-bound dashboard items:

Dashboard Item	Target Axes	Selection	Highlighting
GridDashboardItem	DashboardDataAxisNames.DefaultAxis
ChartDashboardItem	DashboardDataAxisNames.ChartArgumentAxis DashboardDataAxisNames.ChartSeriesAxis
ScatterChartDashboardItem	DashboardDataAxisNames.ChartArgumentAxis
PieDashboardItem	DashboardDataAxisNames.ChartArgumentAxis DashboardDataAxisNames.ChartSeriesAxis
CardDashboardItem	DashboardDataAxisNames.DefaultAxis
GaugeDashboardItem	DashboardDataAxisNames.DefaultAxis
MapDashboardItem	DashboardDataAxisNames.DefaultAxis
TreemapDashboardItem	DashboardDataAxisNames.DefaultAxis

Note

A Grid dashboard item with enabled Cell Merging does not support custom interactivity.

Custom Item Interactivity

You can implement such interactivity as master filter and drill-down for custom dashboard items. The corresponding buttons appear in the Data ribbon tab page’s Interactivity group for a custom item.

Refer to the following tutorial for more information on how to configure master filter and drill-down for the custom Funnel item: Create an Interactive Data-Aware Item for the WinForms Dashboard.

Item Click

You can use the following API to handle mouse actions and get information about clicked elements:

API	Description
DashboardDesigner.DashboardItemClick	Occurs when an end-user clicks a dashboard item.
DashboardDesigner.DashboardItemDoubleClick	Occurs when an end-user double-clicks a dashboard item.
DashboardDesigner.DashboardItemMouseDown	Occurs when the mouse pointer is over the dashboard item and a mouse button is pressed.
DashboardDesigner.DashboardItemMouseUp	Occurs when the mouse pointer is over the dashboard item and a mouse button is released.
DashboardDesigner.DashboardItemMouseEnter	Occurs when the mouse pointer enters the dashboard item.
DashboardDesigner.DashboardItemMouseLeave	Occurs when the mouse pointer leaves the dashboard item.
DashboardDesigner.DashboardItemMouseHover	Occurs when the mouse pointer rests on the dashboard item.
DashboardDesigner.DashboardItemMouseMove	Occurs when the mouse pointer is moved over the dashboard item.