CrosshairElement Class

Represents crosshair elements (e.g., crosshair value lines, crosshair value labels, crosshair labels) that can be used to custom draw a crosshair cursor.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v20.1.dll

Declaration

[NonCategorized]
public class CrosshairElement :
    CrosshairElementBase
<NonCategorized>
Public Class CrosshairElement
    Inherits CrosshairElementBase

Remarks

Use the CustomDrawCrosshairEventArgs.CrosshairElements property to get access to the CrosshairElement object.

To learn more on crosshair cursors, see Tooltip and Crosshair Cursor.

Examples

This example shows how to provide a custom appearance for the crosshair cursor using the ChartControl.CustomDrawCrosshair event. This event is invoked when you click the Custom Draw Crosshair Cursor button on the form.

If you wish to display crosshair axis lines and labels on a chart before custom drawing the crosshair cursor, set the CrosshairOptions.ShowArgumentLabels, CrosshairOptions.ShowArgumentLine, CrosshairOptions.ShowValueLabels and CrosshairOptionsBase.ShowValueLine properties to true.

Note that the customization of the crosshair cursor is provided for the CrosshairOptions.SnapMode property set to NearestArgument.

<Window x:Class="CrosshairCustomDraw.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="350" Width="525" xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts">
    <Grid>
        <StackPanel>
            <dxc:ChartControl Height="269"  Name="chartControl1" CustomDrawCrosshair="chartControl1_CustomDrawCrosshair">
                <dxc:ChartControl.CrosshairOptions>
                    <dxc:CrosshairOptions ShowArgumentLabels="True" ShowArgumentLine="True" 
                        ShowValueLabels="True" ShowValueLine="True"/>
                </dxc:ChartControl.CrosshairOptions>
                <dxc:XYDiagram2D>
                <dxc:LineSeries2D DisplayName="Series1">
                    <dxc:SeriesPoint Argument="1" Value="50"/>
                    <dxc:SeriesPoint Argument="2" Value="44"/>
                    <dxc:SeriesPoint Argument="3" Value="55"/>
                    <dxc:SeriesPoint Argument="4" Value="77"/>
                </dxc:LineSeries2D>
                <dxc:LineSeries2D DisplayName="Series2">
                    <dxc:SeriesPoint Argument="1" Value="22"/>
                    <dxc:SeriesPoint Argument="2" Value="11"/>
                    <dxc:SeriesPoint Argument="3" Value="9"/>
                    <dxc:SeriesPoint Argument="4" Value="8"/>
                </dxc:LineSeries2D>
                </dxc:XYDiagram2D>
            </dxc:ChartControl>
            <Button Height="35" Content="Custom Draw Crosshair Cursor" Click="Button_Click"></Button>
        </StackPanel>
    </Grid>
</Window>

Inheritance

See Also