Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

HeatmapControl.ToolTipOptions Property

Gets or sets tooltip settings for heatmap cells.

Namespace: DevExpress.Xpf.Charts.Heatmap

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

NuGet Package: DevExpress.Wpf.Charts

#Declaration

public HeatmapToolTipOptions ToolTipOptions { get; set; }

#Property Value

Type Description
HeatmapToolTipOptions

Contains options for heatmap cell tooltips.

#Remarks

Set the ToolTipEnabled property to True to enable cell tooltips.

The ToolTipOptions property allows you to specify the following tooltip settings:

  • AutoPopDelay – Gets or sets the time interval during which the tooltip is displayed.

  • CloseOnClick – Specifies whether a tooltip is closed when its corresponding visual element is clicked.

  • InitialDelay – Gets or sets the delay before the tooltip is displayed.

  • OpenMode – Specifies when heatmap tooltips are displayed.

  • Pattern – Gets or sets a format string that is applied to tooltip text.

You can also specify the ToolTipTemplate property to define tooltip appearance.

#Example

The following example shows how to enable tooltips for heatmap cells and configure tooltip options:

Customized tooltip

<Window.Resources>
    <DataTemplate x:Key="tooltipTemplate">
        <StackPanel Orientation="Vertical" Margin="8">
            <Label Foreground="Black" 
                   FontStyle="Italic" 
                   FontSize="14" 
                   Content="{Binding Path=ToolTipText}" />
        </StackPanel>
    </DataTemplate>
</Window.Resources>
<Grid>
    <dxh:HeatmapControl ToolTipEnabled="True" 
                        ToolTipTemplate="{StaticResource ResourceKey=tooltipTemplate}">
        <dxh:HeatmapControl.ToolTipOptions>
            <dxh:HeatmapToolTipOptions ContentMargin="0" 
                                       Pattern="X: {X}&#x0a;Y: {Y}&#x0a;Value: {V}" 
                                       OpenMode="OnHover" 
                                       AutoPopDelay="00:00:03" 
                                       InitialDelay="00:00:00.1" 
                                       CloseOnClick="False"/>
        </dxh:HeatmapControl.ToolTipOptions>
        <!--...-->
    </dxh:HeatmapControl>
</Grid>
See Also