DashboardDesigner.DashboardItemControlUpdated Event

Allows you to access underlying WinForms controls.

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v19.1.Win.dll

Declaration

C#

public event DashboardItemControlUpdatedEventHandler DashboardItemControlUpdated

VB.NET

Public Event DashboardItemControlUpdated As DashboardItemControlUpdatedEventHandler

Event Data

The DashboardItemControlUpdated event's data class is DashboardItemControlEventArgs. The following properties provide information specific to this event:

Property	Description
CardControl	Gets an underlying Card control.
ChartControl	Gets an underlying chart control.
DashboardItemName	Gets the component name of the dashboard item for which the event was raised.
DateFilterControl	Gets an underlying date filter control.
GaugeControl	Gets an underlying gauge control.
GridControl	Gets an underlying grid control.
MapControl	Gets an underlying map control.
PictureEdit	Gets an underlying picture edit control.
PivotGridControl	Gets an underlying PivotGridControl.
RichEditControl	Gets an underlying RichEdit control.
TreeMapControl	Gets an underlying TreeMap control.

Remarks

The DashboardDesigner uses DevExpress WinForms controls to visualize data within dashboard items. The DashboardItemControlUpdated event allows you to access these controls and customize their settings if necessary.

The DashboardItemControlEventArgs.DashboardItemName property returns the component name of the dashboard item to be customized. Use the following properties to access the corresponding underlying controls.

Dashboard Item	Control	Property
GridDashboardItem	GridControl	DashboardItemControlEventArgs.GridControl
ChartDashboardItem PieDashboardItem ScatterChartDashboardItem	ChartControl	DashboardItemControlEventArgs.ChartControl
GaugeDashboardItem	GaugeControl	DashboardItemControlEventArgs.GaugeControl
CardDashboardItem	CardControl	DashboardItemControlEventArgs.CardControl
PivotDashboardItem	PivotGridControl	DashboardItemControlEventArgs.PivotGridControl
MapDashboardItem	MapControl	DashboardItemControlEventArgs.MapControl
TreemapDashboardItem	TreeMapControl	DashboardItemControlEventArgs.TreeMapControl
TextBoxDashboardItem	RichEditControl	DashboardItemControlEventArgs.RichEditControl
ImageDashboardItem	PictureEdit	DashboardItemControlEventArgs.PictureEdit
DateFilterDashboardItem	DateFilterControl	DashboardItemControlEventArgs.DateFilterControl

You can change the control setting or handle its events. To subscribe/unsubscribe from control events, use the DashboardDesigner.DashboardItemControlCreated/DashboardDesigner.DashboardItemBeforeControlDisposed events, respectively.

Note

The dashboard item is re-created when you maximize / restore the item. All events connected with dashboard item life cycle (such as DashboardItemControlCreated, DashboardItemControlUpdated, etc.) are fired again.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DashboardItemControlUpdated event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

win-dashboard-viewer-chartcontrol-checkedlegend-maximized/CS/CheckBoxLegendExample/CheckBoxLegend/ChartLegendHelper.cs#L41

designer.DashboardItemControlCreated += DashboardItemControlCreated;
designer.DashboardItemControlUpdated += DashboardItemControlUpdated;
designer.DashboardItemBeforeControlDisposed += DashboardItemBeforeControlDisposed;

VB.NET

win-dashboard-viewer-chartcontrol-checkedlegend-maximized/VB/CheckBoxLegendExample/CheckBoxLegend/ChartLegendHelper.vb#L39

AddHandler designer.DashboardItemControlCreated, AddressOf DashboardItemControlCreated
AddHandler designer.DashboardItemControlUpdated, AddressOf DashboardItemControlUpdated
AddHandler designer.DashboardItemBeforeControlDisposed, AddressOf DashboardItemBeforeControlDisposed