datachart-categorytooltiplayer.adoc

Category Tooltip Layer

Topic Overview

Purpose

This topic provides information about the category tooltip layer used for hover 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
Getting Started with Data Chart	The {DataChartName} 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.
Category Series	This topic explains various types of Category Series in the {DataChartName} control.

In this topic

This topic contains the following sections:

• Overview

• Preview

• Properties

• Example

• Related Content

Overview

Category tooltip layer overview

The CategoryToolTipLayer displays grouped tooltips for the series on the {DataChartName} 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 {DataChartName} 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 {DataChartName} control renders with the CategoryToolTipLayer added.

Properties

Category tooltip layer summary

The following table summarizes the properties of the CategoryToolTipLayer layer.

Property Name	Property Type	Description
TargetAxis	Axis	This property specifies which axis should have an enabled category tooltip layer.
UseInterpolation	bool	This property specifies if the tooltip’s x position should be interpolated rather than snapping to the gridlines or the center spaces.

Related Content

Topics

Topic	Purpose
Chart Annotation Layers	This topic provides conceptual information about the hover interactions available on the {DataChartName}™ control including the different types of hover interaction layers available.
Common Properties	This topic provides information about the properties and methods that the hover interaction feature uses for highlighting, hovering and interacting with the tooltip interactions inherited from the Series class.
Crosshair Layer	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.
Category Item Highlight Layer	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.
Item Tooltip Layer	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.