DashboardControl.DashboardItemMouseDown Event
Occurs when the mouse pointer is over the dashboard item and a mouse button is released.
Namespace: DevExpress.DashboardWpf
Assembly: DevExpress.Dashboard.v24.1.Wpf.dll
NuGet Package: DevExpress.Wpf.Dashboard
Declaration
Event Data
The DashboardItemMouseDown event's data class is DashboardItemMouseActionWpfEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| DashboardItemName | Gets the name of the dashboard item. Inherited from DashboardItemMouseWpfEventArgs. |
| Data | Gets the data displayed in the dashboard item. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| GetAxisPoint() | Obtains the AxisPoint object located at the top priority axis and related to the visual element under the test point. |
| GetAxisPoint(String) | Obtains the AxisPoint object located at the specified axis and related to the visual element under the test point. |
| GetDeltas() | Gets a list of delta descriptors related to the visual element located under the test point. |
| GetMeasures() | Gets a list of measure descriptors related to the visual element located under the test point. |
| GetSlice() | Returns the data slice for the Default axis by the AxisPoint related to the visual element located under the test point. |
| GetSlice(String) | Returns the data slice for the specified axis by the AxisPoint related to the visual element located under the test point. |
| GetUnderlyingData() | Returns underlying data related to the visual element located under the test point. |
| GetUnderlyingData(IList<String>) | Returns underlying data related to the visual element located under the test point. |
| GetUnderlyingData(String, IList<String>) | Returns underlying data related to the visual element located under the test point. |
| GetUnderlyingData(String) | Returns underlying data related to the visual element located under the test point. |
Remarks
Use the e.DashboardItemName property to obtain the dashboard item name for which the event is raised.
To obtain the data related to the dashboard item element, use the following methods:
- e.Data returns the MultiDimensionalData object;
- e.GetAxisPoint;
- e.GetDeltas;
- e.GetMeasures;
- e.GetUnderlyingData.
The event retrieves data from different dashboard item’s visual elements:
- a cell in PivotDashboardItem
- a row in GridDashboardItem
- a point in ChartDashboardItem
- a point in ScatterChartDashboardItem
- a segment in PieDashboardItem
- a gauge in GaugeDashboardItem
- a card in CardDashboardItem
- a point in TreemapDashboardItem
- an area in ChoroplethMapDashboardItem
- a point/bubble/pie in GeoPointMapDashboardItem
The event has the following limitations:
- This event is not raised for filter elements.
- This event does not obtain data related to the following dashboard items: RangeFilterDashboardItem, ImageDashboardItem, TextBoxDashboardItem. Only the item’s name is available.
- This event does not occur when the mouse pointer hovers over the scroll area and space between elements in the following dashboard items: cards in the CardDashboardItem, pies in the PieDashboardItem and gauges in the GaugeDashboardItem.
- This event does not occur when the mouse pointer hovers over the image paddings in the ImageDashboardItem.