Crosshair in a chart

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Overview
Implementation
Crosshair in a Chart control
Modifying the multiple crosshair by programming
Configuring the crosshair options by programming

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Crosshair in a chart

Overview

In a Line chart, it may be difficult to read the value of axes for a point that is far from these axes.

Via the new crosshair included in all charts, the end user precisely knows the pointed value.

All charts with axes automatically benefit from the crosshair.

The user hovers a point in the chart and the crosshair is displayed!

If the vertical crosshair crosses several lines, the value is displayed for each intersection: it is the multiple crosshair.

For a multiple crosshair, the tooltip header can be customized.

Versions 23 and later

This feature is now available for the PHP sites.

New in version 23

This feature is now available for the PHP sites.

This feature is now available for the PHP sites.

Implementation

Crosshair in a Chart control

The crosshair is available by default for all Chart controls created from version 20.

To display a crosshair in a Chart control:

Display the description window of Chart control.
In the "Details" tab:
- in the "Interactivity" area, check (if necessary) "Interactive chart" then check "Enable the chart crosshair".
  The "Multiple crosshair" option allows you to get a multiple crosshair in the Line or Column charts. Only the interactive Chart controls are available in PHP.
Validate the description window of control.

Notes:

The crosshair is available for the following types of charts: Area, Bubble, Line, Column, MinMax, Radar and Waterfall.
The crosshair characteristics can be defined in the "Style" tab of Chart control: color, opacity and thickness.

Modifying the multiple crosshair by programming

By default, the multiple crosshair displays:

in header, the category name.
the content of different tooltips for the points corresponding to the crosshair.

It is possible to modify the header of the crosshair tooltip via grTooltip associated with the grTooltipFormatCrosshairHeader constant.

For example:

grTooltip(CHART_Chart1, grTooltipFormatCrosshairHeader, "Category: [%CATEGORY%]")

Configuring the crosshair options by programming

The crosshair has the following characteristics by default:

color based on the color of gridlines in the Chart control.
thickness: 1 pixel.
opacity: entirely opaque crosshair.

These characteristics can be modified by the following properties:


Versions 20 and later CrosshairColor New in version 20 CrosshairColor CrosshairColor	..CrosshairColor is used to find out and modify the color of the crosshair for a Chart control.
Versions 20 and later CrosshairOpacity New in version 20 CrosshairOpacity CrosshairOpacity	..CrosshairOpacity is used to find out and modify the opacity of the crosshair for a Chart control.
Versions 20 and later CrosshairThickness New in version 20 CrosshairThickness CrosshairThickness	..CrosshairThickness is used to find out and modify the thickness of the crosshair for a Chart control.

Related Examples:

Training (WINDEV): WD Chart

[ + ] This educational example present different uses of the chart control.
The following charts are presented:
- Semi-circular
- Donut
- Pie
- Sunburst
- Line
- Scatter
- 3D Scatter
- Column
- Area
- Bubble
- Radar
- Funnel
- Surface
- Waterfall
- Composite

The main features presented in this example are the ability to customize the charts by programming as well as the method used to fill a chart from a HFSQL file or in the editor.