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.