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
public class Hint :
HintBase
#Related API Members
The following members return Hint objects:
#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:
#How to: Enable Hints in the ChartView
The following code modifies the general properties of the hint the ChartView
displays:
<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 |
---|---|
Gets or sets the chart hints. | |
| Configures hints the the hints the Chart |
Gets or sets whether the chart displays hints when a user taps chart, and when a hint is requested in code. | |
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.
The following code configures this hint behavior and manages how the hint interacts with this series:
<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 |
---|---|
Gets or sets the behavior of the hint. | |
Defines the tooltip behavior. | |
| |
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.
The following code configures this hint behavior and manages how the hint interacts with the series and axes:
<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>
The markup above uses the classes and properties below:
Symbols | Description |
---|---|
Gets or sets the behavior of the hint. | |
Defines the crosshair hint behavior. | |
| |
Stores the series’ crosshair cursor settings. | |
Gets or sets an object that configures how the axis interacts with the Hint. | |
Stores settings that specify how the axis interacts with the crosshair cursor. |
#How to: Customize the Hint Appearance
The Hint.Style manages the hint appearance. The style configures the following hint elements:
Hint Element | Property | Description |
---|---|---|
1. Hint Label | Gets or sets the hint label’s background color. | |
Gets or sets the indent between crosshair hint label items. | ||
Gets or sets the hint’s marker size. | ||
Gets or sets the hint’s label padding. | ||
Gets or sets the indent between a hint marker and text. | ||
2. Argument Line | Gets or sets the options that configure the argument line appearance for the crosshair hint. | |
3. Value Line | Gets or sets the options that configure the value line appearance for the crosshair hint. |