DashboardDesigner.DashboardItemBeforeControlDisposed Event

Allows you to access underlying WinForms controls.

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v18.2.Win.dll

Declaration

C#

public event DashboardItemBeforeControlDisposedEventHandler DashboardItemBeforeControlDisposed

VB.NET

Public Event DashboardItemBeforeControlDisposed As DashboardItemBeforeControlDisposedEventHandler

Event Data

The DashboardItemBeforeControlDisposed 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.
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 DashboardDesigner.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

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

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DashboardItemBeforeControlDisposed 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#L42

    designer.DashboardItemControlUpdated += DashboardItemControlUpdated;
    designer.DashboardItemBeforeControlDisposed += DashboardItemBeforeControlDisposed;
}

VB.NET

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

    AddHandler designer.DashboardItemControlUpdated, AddressOf DashboardItemControlUpdated
    AddHandler designer.DashboardItemBeforeControlDisposed, AddressOf DashboardItemBeforeControlDisposed
End Sub