Hint Class

Configures hints the the hints the ChartView displays.

Namespace : DevExpress.XamarinForms.Charts

Assembly : DevExpress.XamarinForms.Charts.dll

NuGet Package : DevExpress.XamarinForms.Charts

Declaration

csharp

public class Hint :
    HintBase

The following members return Hint objects:

ChartView.Hint

Remarks

A hint is a small pop-up rectangle that shows information about a tapped series or point. The Chart View can display its hints as Tooltips and as a Crosshair Cursor:

Tooltip

Crosshair Cursor

How to: Enable Hints in the ChartView

The following code modifies the general properties of the hint the ChartView displays:

XAML

xml

<dxc:ChartView>
    <dxc:ChartView.Hint>
        <dxc:Hint Enabled="True" 
                  ShowMode="OnTap"/>
    </dxc:ChartView.Hint>
</dxc:ChartView>

The code above utilizes the following properties and classes:

Symbol

Description

| | --- | --- | |

ChartView.Hint

Gets or sets the chart hints.

| |

Hint

Configures hints the the hints the ChartView displays.

| |

HintBase.Enabled

Gets or sets whether the chart displays hints when a user taps chart, and when a hint is requested in code.

| |

HintBase.ShowMode

Gets or sets a gesture on which the chart shows hints.

How to: Change the Hint Behavior

The Hint provides the following behaviors that manage how the chart displays the hint:

Tooltip Behavior

The chart shows the hint as a tooltip:

Note

The Tooltip requests data to display from a series. The series provides the Series.HintOptions property to configure what data the series returns.

The following code configures this hint behavior and manages how the hint interacts with this series:

XAML

<dxc:ChartView>
    <dxc:ChartView.Hint>
        <dxc:Hint>
            <dxc:Hint.Behavior>
                <dxc:TooltipHintBehavior/>
            </dxc:Hint.Behavior>
        </dxc:Hint>
    </dxc:ChartView.Hint>
    <dxc:ChartView.Series>
        <dxc:BarSeries>
            <dxc:BarSeries.HintOptions>
                <dxc:SeriesHintOptions PointTextPattern="{}{S}, {A}: {V$0.##}"/>
            </dxc:BarSeries.HintOptions>
        </dxc:BarSeries>
    </dxc:ChartView.Series>
</dxc:ChartView>

The code above utilizes the following classes and properties:

Symbols

Description

| | --- | --- | |

Hint.Behavior

Gets or sets the behavior of the hint.

| |

TooltipHintBehavior

Defines the tooltip behavior.

| |

Series.HintOptions

| |

SeriesHintOptions

Stores the series’ tooltip settings.

Crosshair Cursor Behavior

The chart shows the hint as the Crosshair Cursor:

Note

The Crosshair Cursor requests data to display from a series and axes. The series provides the Series.HintOptions property to configure what data the series returns. The AxisBase.HintOptions property manages how the hint interacts with the axis.

The following code configures this hint behavior and manages how the hint interacts with the series and axes:

XAML

xml

<dxc:ChartView>
    <dxc:ChartView.Hint>
        <dxc:Hint>
            <dxc:Hint.Behavior>
                <dxc:CrosshairHintBehavior GroupHeaderTextVisible="False"/>
            </dxc:Hint.Behavior>
        </dxc:Hint>
    </dxc:ChartView.Hint>
    <dxc:ChartView.AxisY>
        <dxc:NumericAxisY>
            <dxc:NumericAxisY.HintOptions>
                <dxc:AxisHintOptions LineVisible="False" LabelVisible="False"/>
            </dxc:NumericAxisY.HintOptions>
        </dxc:NumericAxisY>
    </dxc:ChartView.AxisY>
    <dxc:ChartView.Series>
        <dxc:BarSeries>
            <dxc:BarSeries.HintOptions>
                <dxc:SeriesCrosshairOptions PointTextPattern="{}{S}, {A}: {V$0.##}"/>
            </dxc:BarSeries.HintOptions>
        </dxc:BarSeries>
    </dxc:ChartView.Series>
</dxc:ChartView>