<Chart>.Tooltip (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Chart management functions

Tooltip options to configure

Enabling/Disabling the tooltip

Formatting the elements displayed in the tooltip

See also

<Chart>.Tooltip (Function)

In french: <Graphe>.Bulle

Displays and formats:

the tooltip associated with each chart section (section for a Pie chart, bar for a Column chart, etc.). Also allows you to find out the characteristics of the tooltip associated with each chart section.
Versions 23 and later
a custom tooltip, associated with a point.
New in version 23
a custom tooltip, associated with a point.
a custom tooltip, associated with a point.

By default, a tooltip is automatically displayed (grShowTooltip set to True) when a chart is hovered by the mouse cursor.

In a page of a WEBDEV site, the chart must be interactive in order for the tooltip to be displayed. To make the chart interactive, check "Interactive chart" in the "Details" tab of the control description.

Versions 19 and later

This function is now available for iPhone/iPad applications.

New in version 19

This function is now available for iPhone/iPad applications.

Versions 20 and later

This function is now available for the WEBDEV sites in Windows and Linux.

New in version 20

This function is now available for the WEBDEV sites in Windows and Linux.

Versions 23 and later

This function is now available for PHP sites.

This function is now available for Android applications.

New in version 23

This function is now available for PHP sites.

This function is now available for Android applications.

This function is now available for PHP sites.

This function is now available for Android applications.

Versions 25 and later

This function is now available in browser code.

New in version 25

This function is now available in browser code.

Example

// Champ Graphe
// Affichage des pourcentages sur un histogramme
GRF_MonGraphe.Libellé(grAffichePourcentage, Vrai)
GRF_MonGraphe.Bulle(grFormatBulle, -%"[%SERIE%]" + RC + -%"[%CATEGORIE%]" + RC + -%"[%VALEUR%]")
GRF_MonGraphe.Bulle(grBulleActive, Vrai)
// Dessin du graphe
GRF_MonGraphe.Dessine()

Versions 23 and later

// Champ Graphe
// Affichage d'une bulle spécifique pour un point
GRF_MonGraphe.Bulle(1, 2, "Le contenu de ma bulle d'aide")
// Dessin du graphe
GRF_MonGraphe.Dessine()

New in version 23

// Champ Graphe
// Affichage d'une bulle spécifique pour un point
GRF_MonGraphe.Bulle(1, 2, "Le contenu de ma bulle d'aide")
// Dessin du graphe
GRF_MonGraphe.Dessine()

Syntax

Displaying and formatting the tooltip associated with a Chart control Hide the details

<Chart control>.Tooltip(<Tooltip option to configure> , <Value of tooltip option>)

<Chart control>: Control name

Name of the Chart control to use (found in the window editor).
Only the interactive Chart controls are available.

<Tooltip option to configure>: Integer constant

Enables or disables the tooltip and configures its characteristics.
grShowTooltip Enables or disables the tooltip.
grTooltipFormat Describes the tooltip format.
grTooltipFormatStock Describes the tooltip format for a Stock chart.
This constant is not available.
Versions 20 and later
grTooltipFormatCrosshairHeader
New in version 20
grTooltipFormatCrosshairHeader
grTooltipFormatCrosshairHeader Describes the header format for the chart crosshairs.
Versions 16 and later
grTooltipFormatBubbleChart
New in version 16
grTooltipFormatBubbleChart
grTooltipFormatBubbleChart Describes the tooltip format for a Bubble chart.
This constant is not available.
Versions 21 and later
grTooltipFormatHeatMap
New in version 21
grTooltipFormatHeatMap
grTooltipFormatHeatMap Describes the tooltip format for a Heatmap chart.
This constant is not available.
grTooltipFormatScatter Describes the tooltip format for a Scatter chart.
This constant is not available.
grTooltipFormatPie Describes the tooltip format for a Pie chart.
Versions 26 and later
grTooltipFormatRangeArea
New in version 26
grTooltipFormatRangeArea
grTooltipFormatRangeArea Describes the tooltip format for an interval Zone graph.

<Value of tooltip option>: Character string or boolean

Value of option for the selected tooltip. This value depends on the selected option (see the above table).

Finding out the characteristics of tooltip associated with a Chart control Hide the details

<Result> = <Chart control>.Tooltip(<Tooltip option>)

<Result>: Type corresponding to the option (boolean or character string)

Value of sought option.

<Chart control>: Control name

Name of the Chart control to use (found in the window editor).
Only the interactive Chart controls are available.

<Tooltip option>: Integer constant

Tooltip option whose value is requested.
grShowTooltip Enables or disables the tooltip.
grTooltipFormat Describes the tooltip format.
grTooltipFormatStock Describes the tooltip format for a Stock chart.
This constant is not available.
Versions 20 and later
grTooltipFormatCrosshairHeader
New in version 20
grTooltipFormatCrosshairHeader
grTooltipFormatCrosshairHeader Describes the header format for the chart crosshairs.
Versions 16 and later
grTooltipFormatBubbleChart
New in version 16
grTooltipFormatBubbleChart
grTooltipFormatBubbleChart Describes the tooltip format for a Bubble chart.
This constant is not available.
Versions 21 and later
grTooltipFormatHeatMap
New in version 21
grTooltipFormatHeatMap
grTooltipFormatHeatMap Describes the tooltip format for a Heatmap chart.
This constant is not available.
grTooltipFormatScatter Describes the tooltip format for a Scatter chart.
This constant is not available.
grTooltipFormatPie Describes the tooltip format for a Pie chart.
Versions 26 and later
grTooltipFormatRangeArea
New in version 26
grTooltipFormatRangeArea
grTooltipFormatRangeArea Describes the tooltip format for an interval Zone graph.
This constant is not available.

Displaying and customizing the tooltip associated with a point Hide the details

<Chart control>.grTooltip(<Series number> , <Category number> , <Tooltip value>)

<Chart control>: Control name

Name of the Chart control to use (found in the window editor or the page editor).
Only the interactive Chart controls are available.

<Series number>: Integer

Number of the series to use.

<Category number>: Integer

Number of the category to use.

<Tooltip value>: Character string

Custom text of tooltip associated with the point.

Remarks

Tooltip options to configure

Constant	Effect	Value of option

grShowTooltip	Enables or disables the tooltip.	Boolean True (by default) to enable the tooltip, False to avoid displaying it. Caution: the parameters defined for the tooltip are not re-initialized during the display.
grTooltipFormat	Describes the tooltip format.	Character string Empty string to use the default format. Combination of following strings: [%SERIES%]: Displays the series label (defined with function <Chart>.SeriesLabel). [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). [%VALUE%]: Displays the value Example: "[%VALUE%]"+RC+"[%CATEGORY%]" By default, the format is as follows: "[%CATEGORY%]"+CR+"[%SERIES%]"+"="+"[%VALUE%]"
grTooltipFormatStock	Describes the tooltip format for a Stock chart.	Character string Empty string to use the default format. Combination of following strings: [%SERIES%]: Displays the series label (defined with function <Chart>.SeriesLabel). [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). [%MAX%]: Displays the maximum value of the session. [%MIN%]: Displays the minimum value of the session. [%DEBUT%]: Displays the first value of the session. [%FIN%]: Displays the end value of the session. By default, the format is as follows: "[%CATEGORY%]"+CR+"Min.=[%MIN%]"+CR+"Max.=[%MAX%]"+CR+"Start=[%START%]"+CR+"End=[%END%]"
Versions 27 and later grTooltipFormatRadialBar New in version 27 grTooltipFormatRadialBar grTooltipFormatRadialBar	Describes the tooltip format for a progress circle graph.	Character string Empty string to use the default format. Combination of following strings: [%SERIES%]: Displays the series label (defined with function <Chart>.SeriesLabel). [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). [%VALUE%]: Displays the value [%%%]: Displays the percentage Example: "[%VALUE%]"+CR+"[%CATEGORY%]"+CR+"[%%%]" By default, the format is as follows: "[%CATEGORY%]"+CR+"[%VALUE%]"+CR+"[%%%]"
Versions 20 and later grTooltipFormatCrosshairHeader New in version 20 grTooltipFormatCrosshairHeader grTooltipFormatCrosshairHeader	Describes the header format for the chart crosshairs.	Character string Empty string to use the default format. Character string containing the following string: [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). By default, the format is as follows: "[%CATEGORY%]" Versions 22 and later Stacked Column chart: The total of stack can be added into the tooltip of a stacked column chart by using the following syntax: GRF_MonGraphe.grBulle(grFormatBulleEntêteMire, ... "[%CATEGORIE%], Somme = [%VALEUR%]") New in version 22 Stacked Column chart: The total of stack can be added into the tooltip of a stacked column chart by using the following syntax: GRF_MonGraphe.grBulle(grFormatBulleEntêteMire, ... "[%CATEGORIE%], Somme = [%VALEUR%]") Stacked Column chart: The total of stack can be added into the tooltip of a stacked column chart by using the following syntax: GRF_MonGraphe.grBulle(grFormatBulleEntêteMire, ... "[%CATEGORIE%], Somme = [%VALEUR%]")
Versions 16 and later grTooltipFormatBubbleChart New in version 16 grTooltipFormatBubbleChart grTooltipFormatBubbleChart	Describes the tooltip format for a bubble chart.	Character string Empty string to use the default format. Combination of following strings: [%SERIES%]: Displays the series label (defined with function <Chart>.SeriesLabel). [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). [%X%]: Displays the X-coordinate (first series) [%Y%]: Displays the Y-coordinate (second series) [%Z%]: Displays the value of the third series. By default, the format is as follows: "([%X%];[%Y%]): [%Z%]"+RC+"[%CATEGORY%]"
grTooltipFormatScatter	Describes the tooltip format for a Scatter chart.	Character string Empty string to use the default format. Combination of following strings: [%SERIES%]: Displays the series label (defined with function <Chart>.SeriesLabel). [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). [%X%]: Displays the X-coordinate. By default, the format is as follows: "[%X%]"+CR+"[%Y%]"+CR+"[%SERIES%]"+CR+"[%CATEGORY%]"
Versions 21 and later grTooltipFormatHeatMap New in version 21 grTooltipFormatHeatMap grTooltipFormatHeatMap	Describes the tooltip format for a Heatmap chart.	Character string Empty string to use the default format. Combination of following strings: [%SERIES%]: Displays the series label (defined with function <Chart>.SeriesLabel). [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). [%X%]: Displays the X-coordinate (first series) [%Y%]: Displays the Y-coordinate (second series) [%Z%]: Displays the value of the third series. By default, the format is as follows: "([%X%];[%Y%]): [%Z%]"+RC+"[%CATEGORY%]"
grTooltipFormatPie	Describes the tooltip format for a Pie chart.	Character string Empty string to use the default format. Combination of following strings: [%SERIES%]: Displays the series label (defined with function <Chart>.SeriesLabel). [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). [%VALUE%]: Displays the value [%%%]: Displays the percentage Example: "[%VALUE%]"+CR+"[%CATEGORY%]"+CR+"[%%%]" By default, the format is as follows: "[%CATEGORY%]"+CR+"[%VALUE%]"+CR+"[%%%]"
Versions 26 and later grTooltipFormatRangeArea New in version 26 grTooltipFormatRangeArea grTooltipFormatRangeArea	Describes the tooltip format for an interval Zone graph.	Character string Empty string to use the default format. Combination of following strings: [%DEBUT%]: Displays the start value of interval. [%FIN%]: Displays the end value of the interval. [%CATEGORY%]: Displays the category label (defined with function <Chart>.CategoryLabel). Example: "[%DEBUT%]"+RC+"[%FIN%]"+RC+"[%CATEGORY%]" By default, the format is as follows: "[%DEBUT%]"+RC+"[%FIN%]

If the default format is used:

the string "[%CATEGORY%]" is ignored if no category label has been specified with the <Chart>.CategoryLabel function.
the string "[%SERIE%]" is ignored if no series label has been specified with the <Chart>.SeriesLabel function.

Versions 22 and later
Caution: If you use dynamic string construction (option "Allow "[% %]" in strings" in the "Compilation" tab of the description project), a compilation error appears (unknown identifier). In this case, each string must be preceded by '-%'. Example:

GRF_Echéance.Bulle(grFormatBulle, "[%CATEGORIE%]" + RC + RC+ "[%VALEUR%]" + " H")

becomes

GRF_Echéance.Bulle(grFormatBulle, -%"[%CATEGORIE%]" + RC + RC + -%"[%VALEUR%]" + " H")

New in version 22
Caution: If you use dynamic string construction (option "Allow "[% %]" in strings" in the "Compilation" tab of the description project), a compilation error appears (unknown identifier). In this case, each string must be preceded by '-%'. Example:

GRF_Echéance.Bulle(grFormatBulle, "[%CATEGORIE%]" + RC + RC+ "[%VALEUR%]" + " H")

becomes

GRF_Echéance.Bulle(grFormatBulle, -%"[%CATEGORIE%]" + RC + RC + -%"[%VALEUR%]" + " H")

Caution: If you use dynamic string construction (option "Allow "[% %]" in strings" in the "Compilation" tab of the description project), a compilation error appears (unknown identifier). In this case, each string must be preceded by '-%'. Example:

GRF_Echéance.Bulle(grFormatBulle, "[%CATEGORIE%]" + RC + RC+ "[%VALEUR%]" + " H")

becomes

GRF_Echéance.Bulle(grFormatBulle, -%"[%CATEGORIE%]" + RC + RC + -%"[%VALEUR%]" + " H")

Enabling/Disabling the tooltip

The activation/deactivation of the tooltip (constant grShowTooltip) is only taken into account when the <Chart>.Draw function is executed.

The tooltip activation/deactivation (grShowTooltip constant) is taken into account immediately.

Formatting the elements displayed in the tooltip

To format the values displayed in the tooltip (value and percentage), use <Chart>.Mask.

Component: wd270grf.dll