Back to Devexpress

ChartControl.ToolTipController Property

wpf-devexpress-dot-xpf-dot-charts-dot-chartcontrol-bbbdf95a.md

latest4.3 KB
Original Source

ChartControl.ToolTipController Property

Gets or sets the tooltip controller component that controls the appearance, position and other settings of tooltips displayed for the Chart control.

Namespace : DevExpress.Xpf.Charts

Assembly : DevExpress.Xpf.Charts.v25.2.dll

NuGet Package : DevExpress.Wpf.Charts

Declaration

csharp
public ChartToolTipController ToolTipController { get; set; }
vb
Public Property ToolTipController As ChartToolTipController

Property Value

TypeDescription
ChartToolTipController

The tooltip controller.

|

Remarks

Before the tooltip customization, make sure the ChartControl.ToolTipEnabled property is set to true.

Use properties of the ChartToolTipController object to customize the tooltip appearance on a chart (e.g., ChartToolTipController.ShowBeak, ChartToolTipController.ShowShadow) and define the tooltip behavior (e.g, ChartToolTipController.CloseOnClick, ChartToolTipController.OpenMode, ChartToolTipController.InitialDelay).

For more information on how to use a tooltip in your application, see the Tooltip topic.

Example

This example demonstrates how to show a tooltip when a user clicks a series point.

Set the ChartControl.ToolTipEnabled property to true to enable tooltips. Until you disable ChartControlBase.CrosshairEnabled, the Crosshair Cursor and tooltip are shown simultaneously.

To invoke a tooltip for a marker series, such as LineSeries2D, user should click or hover over a point marker. Set the LineSeries2D.MarkerVisible property to true to enable markers.

The Series.ToolTipPointPattern property defines the text shown in a tooltip for a point.

To customize the tooltip behavior, initialize the ChartControl.ToolTipController property with an ChartToolTipController object. Specify its ChartToolTipController.OpenMode, ChartToolTipController.ShowShadow, ChartToolTipController.InitialDelay, and ChartToolTipController.ContentMargin properties.

xaml
<dxc:ChartControl CrosshairEnabled="False" 
                  ToolTipEnabled="True">
    <dxc:ChartControl.ToolTipController>
        <dxc:ChartToolTipController OpenMode="OnClick" 
                                    ShowShadow="False" 
                                    InitialDelay="0:0:0.4" 
                                    ContentMargin="4"/>
    </dxc:ChartControl.ToolTipController>
    <dxc:XYDiagram2D>
        <dxc:LineSeries2D MarkerVisible="True"
                          ToolTipPointPattern="{}Argument: {A}&#x0a;Value: {V:f3}"/>
    </dxc:XYDiagram2D>                      
</dxc:ChartControl>

See Also

ChartControl Class

ChartControl Members

DevExpress.Xpf.Charts Namespace