Skip to main content

Access to Underlying Widgets in ASP.NET Core

  • 2 minutes to read


This topic shows the ASP.NET Core specifics. The main widget customization concepts are described in the following article: Access to Underlying Widgets in DashboardControl.

  • Most dashboard items use DevExtreme UI widgets to visualize data. Use the DashboardControl‘s API to access these widgets and customize their settings. In ASP.NET Core, you need to subscribe to the ViewerApiExtension events that allow you to access underlying UI/Data Visualization widgets. For this, use the DashboardBuilder.OnBeforeRender event handler, call the ViewerApiExtension.on method and pass the event name as the method’s parameter.

  • Several dashboard items use built-in components instead of DevExtreme-based UI widgets.

  • Layout items do not have underlying components.

See the table in the following topic for information about dashboard items and their underlying components: Access to Underlying Widgets in DashboardControl.


The example shows how to customize options of underlying widgets. Handle the onItemWidgetOptionsPrepared event to do the following:

  • Highlight a hovered grid row in the underlying dxDataGrid.
  • Disable a standard tooltip that appears when a user hovers over a chart’s series point.
  • Create a custom tooltip that appears when a user clicks a label on the chart’s argument axis. The onArgumentAxisClick property executes a function that invokes the custom tooltip.
  • Enable the animation for the dxChart and dxPieChart widgets.
  • Display a legend in the dxPieChart widget.

View Example


<div style="position: absolute; left: 0; top: 0; right: 0; bottom: 0;">