HotTrackEventArgs.Object Property

Gets the chart element, for which the event was raised.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.2.dll

Declaration

C#

public object Object { get; }

VB.NET

Public ReadOnly Property Object As Object

Property Value

Type	Description
Object	A Object which represents the chart element for which the event was raised.

Example

This example demonstrates how to implement custom hot-tracking and selection of the chart’s elements at runtime.

Note

To enable runtime hot-tracking and selection, the ChartControl.RuntimeSelection property should be set to true.

If you want to change the default hot-tracking and selection, you should handle the ChartControl.ObjectHotTracked and ChartControl.ObjectSelected events, implement your custom hot-tracking and selection approaches and set the Cancel property to true.

For example, the code below illustrates how to disable selection and hot-tracking of a chart’s diagram.

C#

using DevExpress.XtraCharts;
// ...

private void chartControl1_ObjectHotTracked(object sender, HotTrackEventArgs e) {
   // Prevent the chart's diagram from being hot-tracked.
   if (e.Object is Diagram) 
      e.Cancel = true;
}

private void chartControl1_ObjectSelected(object sender, HotTrackEventArgs e) {
   // Prevent the chart's Diagram from being selected.
   if (e.Object is Diagram) 
      e.Cancel = true;
}

VB.NET

Imports DevExpress.XtraCharts
' ...

Private Sub OnObjectHotTracked(sender As Object, e As HotTrackEventArgs) _
Handles ChartControl1.ObjectHotTracked
   ' Prevent the chart's Diagram from being hot-tracked.
   If TypeOf e.Object Is Diagram Then
      e.Cancel = True
   End If
End Sub

Private Sub OnObjectSelected(sender As Object, e As HotTrackEventArgs) _
Handles ChartControl1.ObjectSelected
   ' Prevent the chart's Diagram from being selected.
   If TypeOf e.Object Is Diagram Then
      e.Cancel = True
   End If
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Object property.

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#

how-to-integrate-a-charting-module-example-solution-e4636/CS/InventoryChart_6/Form1.cs#L60

{
    if (e.HitInfo.InAnnotation && e.Object is TextAnnotation)
        Cursor.Current = Cursors.Hand;

how-to-show-chart-legend-with-markers-in-separate-control-e2366/CS/Form1.cs#L63

{
    gridView1.FocusedRowHandle = gridView1.GetRowHandle(chart.Series.IndexOf(((Series)e.Object)));

how-to-implement-custom-hot-tracking-and-selection-e1947/CS/WindowsApplication3/Form1.cs#L23

// Prevent the chart's diagram from being selected.
if (e.Object is XYDiagram) {
    e.Cancel = true;

winforms-charts-manage-crosshair-cursor-visibility-in-printed-chart/CS/PrintCrosshairSample/Form1.cs#L17

private void OnChartObjectHotTracked(object sender, HotTrackEventArgs e) {
    if (!(e.Object is Series))
        e.Cancel = true;

VB.NET

how-to-integrate-a-charting-module-example-solution-e4636/VB/InventoryChart_6/Form1.vb#L42

    End If
ElseIf e.HitInfo.InAnnotation AndAlso TypeOf e.Object Is TextAnnotation Then
    Me.inventoryChart.Annotations(0).Visible = False

how-to-show-chart-legend-with-markers-in-separate-control-e2366/VB/Form1.vb#L64

If e.HitInfo.InSeries Then
    gridView1.FocusedRowHandle = gridView1.GetRowHandle(chart.Series.IndexOf((CType(e.Object, Series))))

how-to-implement-custom-hot-tracking-and-selection-e1947/VB/WindowsApplication3/Form1.vb#L25

' Prevent the chart's diagram from being selected.
If TypeOf e.Object Is XYDiagram Then
    e.Cancel = True

winforms-charts-manage-crosshair-cursor-visibility-in-printed-chart/VB/PrintCrosshairSample/Form1.vb#L19

Private Sub OnChartObjectHotTracked(ByVal sender As Object, ByVal e As HotTrackEventArgs)
    If Not (TypeOf e.Object Is Series) Then
        e.Cancel = True