Version

Category Tooltip Layer

Topic Overview

Purpose

This topic provides information about the category tooltip layer used for interactions. It describes the properties of the category tooltip layer and provides an example of its implementation.

Required background

The following topics are prerequisites to understanding this topic:

Topic Purpose

The UltraDataChart control requires a data object model to be mapped to control’s DataContext property. This article will provide a simple data object model but you can create your own and use it with this sample code instead.

This topic explains various types of Category Series in the UltraDataChart control.

In this topic

This topic contains the following sections:

Overview

Category tooltip layer overview

The CategoryToolTipLayer displays grouped tooltips for the series on the UltraDataChart control using a category axis.

You can configure tooltips to target a specific axis. This can be done be setting the TargetAxis property. For more information on this property, see the Properties section below.

By default the grouped tooltips appear at the top of the UltraDataChart control; however this default value can be overridden by setting the ToolTipPosition property. For more information on this property, see the CategoryToolTipLayer properties section below.

Preview

The following image is a preview of the UltraDataChart control renders with the CategoryToolTipLayer added.

Category Tooltip Layer 3.png

Properties

Category tooltip layer summary

The following table summarizes the properties of the CategoryToolTipLayer layer.

Property Name Property Type Description

Axis

This property specifies which axis should have an enabled category tooltip layer.

bool

This property specifies if the tooltip’s x position should be interpolated rather than snapping to the gridlines or the center spaces.

Example

The following screenshot illustrates how the UltraDataChart control renders with the CategoryToolTipLayer object’s ToolTipPosition property configured with the following setting:

Property Value

InsideStart

Category Tooltip Layer 4.png

Following is the code used in this implementation

First, enable the default tooltip.

In C#

series.ShowDefaultTooltip = true;

Next, set up the CategoryToolTipLayer.

In C#:

var catToolTipLayerSeries = new CategoryToolTipLayer();
catToolTipLayerSeries.ToolTipPosition = CategoryTooltipLayerPosition.InsideStart;
chart.Series.Add(catToolTipLayerSeries);

Related Content

Topic Purpose

This topic provides information about the crosshair layer used for hover interactions. It describes the properties of the crosshair layer and provides an implementation example.

This topic provides information about the category item highlight layer used for hover interactions. It describes the properties of the category item highlight layer and provides an example of its implementation.

This topic provides information about the item tooltip layer which is used for hover interactions. It describes the properties of the item tooltip layer and also provides an example of its implementation.