|
|
|
|
|
|
|
|
|
|
- Tooltip options to configure
- Enabling/Disabling the tooltip
- Formatting the elements displayed in the tooltip
<Chart>.Tooltip (Function) In french: <Graphe>.Bulle Displays and formats: - the tooltip associated with each graph section (sector for a Pie chart, bar for a Bar chart, etc.). This function also gets the characteristics of the tooltip associated with each section of the chart.
- 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.
GRF_MonGraphe.Libellé(grShowPercent, True)
GRF_MonGraphe.Bulle(grTooltipFormat, -%"[%SERIE%]" + CR + -%"[%CATEGORIE%]" + CR + -%"[%VALEUR%]")
GRF_MonGraphe.Bulle(grShowTooltip, True)
GRF_MonGraphe.Dessine()
GRF_MonGraphe.Bulle(1, 2, "Le contenu de ma bulle d'aide")
GRF_MonGraphe.Dessine()
Syntax
Displaying and formatting the tooltip associated with a Chart control Hide the details
<Chart control>.Tooltip(<Tooltip option to configure> , <Tooltip option value>)
<Chart control>: Control name Name of the Chart control to use (in the window editor).
<Tooltip option to configure>: Integer constant Enables or disables the tooltip and configures its characteristics. | |  New in version 2025grFormatBubbleInternalWindow | Name of the internal window used to display a custom bubble. | | grShowTooltip | Enables or disables the tooltip. | | grTooltipFormat | Defines the tooltip format. | | grTooltipFormatBubbleChart | Defines the tooltip format in a Bubble chart.
| | grTooltipFormatCrosshairHeader | Defines the format of the chart crosshair header. | | grTooltipFormatHeatMap | Defines the tooltip format in a Heatmap chart.
| | grTooltipFormatPie | Defines the tooltip format in a Pie chart. | | grTooltipFormatRangeArea | Defines the tooltip format in a Range Area chart. | | grTooltipFormatScatter | Defines the tooltip format in a Scatter chart.
| | grTooltipFormatStock | Defines the tooltip format in a Stock chart.
| | grTooltipFormatWaffle | Defines the tooltip format in a Waffle chart. |
<Tooltip option value>: Character string or boolean Value of the selected tooltip option. This value depends on the selected option (see the above table).
Getting the characteristics of the 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 the search option. <Chart control>: Control name Name of the Chart control to use (in the window editor).
<Tooltip option>: Integer constant Tooltip option whose value you want to get. | | New in version 2025grFormatBubbleInternalWindow | Name of the internal window used to display a custom bubble. | | grShowTooltip | Enables or disables the tooltip. | | grTooltipFormat | Defines the tooltip format. | | grTooltipFormatBubbleChart | Defines the tooltip format in a Bubble chart.
| | grTooltipFormatCrosshairHeader | Defines the format of the chart crosshair header. | | grTooltipFormatHeatMap | Defines the tooltip format in a Heatmap chart.
| | grTooltipFormatPie | Defines the tooltip format in a Pie chart. | | grTooltipFormatRangeArea | Defines the tooltip format in a Range Area chart.
| | grTooltipFormatScatter | Defines the tooltip format in a Scatter chart.
| | grTooltipFormatStock | Defines the tooltip format in a Stock chart.
| | grTooltipFormatWaffle | Defines the tooltip format in a Waffle chart. |
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 (in the window or page editor).
<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 the tooltip associated with the point. Remarks Tooltip options to configure | | | | Constant | Effect | Option value |
|---|
| grShowTooltip | Enables or disables the tooltip. | Boolean- True (default) to activate the tooltip,
- False to disable the tooltip.
Caution: - Tooltip parameters are not reset on display.
- The constant grBulleActive must be used to activate the bubble, regardless of the bubble's settings.
| | grTooltipFormat | Defines the tooltip format. | Character string- Empty string to use the default format.
- Combination of the following strings:
[%SERIE%]: Displays the series label (defined with the <Chart>.SeriesLabel function)..
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
[%VALUE%]: Displays the value
Example: "[%VALUE%]"+CR+"[%CATEGORY%]"
The default format is: "[%CATEGORY%]"+RC+"[%SERIES%]"+"="+"[%VALUE%]" | | grTooltipFormatStock | Defines the tooltip format in a Stock chart. | Character string- Empty string to use the default format.
- Combination of the following strings:
[%SERIE%]: Displays the series label (defined with the <Chart>.SeriesLabel function)..
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
[%MAX%]: Displays the session's maximum value.
[%MIN%]: Displays the session's minimum value.
[%DEBUT%]: Displays the first value of the session.
[%FIN%]: Displays the session end value.
By default, the format is as follows:
"[%CATEGORY%]"+CR+"Min.=[%MIN%]"+CR+"Max.=[%MAX%]"+CR+"Open=[%OPEN%]"+CR+"Close=[%CLOSE%]" | | grTooltipFormatRadialBar | Defines the tooltip format in a Radial Bar chart. | Character string
- Empty string to use the default format.
- Combination of the following strings:
[%SERIE%]: Displays the series label (defined with the <Chart>.SeriesLabel function)..
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
[%VALUE%]: Displays the value
[%%%]: Displays the percentage
Exemple: "[%VALEUR%]"+RC+"[%CATEGORIE%]"+RC+"[%%%]"
The default format is "[%CATEGORY%]"+RC+"[%VALUE%]"+RC+"[%%%]" | | grTooltipFormatCrosshairHeader | Defines the format of the chart crosshair header. | Character string- Empty string to use the default format.
- Character string containing the following string:
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
The default format is "[%CATEGORY%]".
Stacked histogram graph: You can add the stack total to the tooltip of a stacked histogram using the following syntax:
GRF_MonGraphe.grBulle(grTooltipFormatCrosshairHeader, ...
"[%CATEGORIE%], Somme = [%VALEUR%]")
| | grTooltipFormatBubbleChart | Defines the tooltip format in a Bubble chart. | Character string- Empty string to use the default format.
- Combination of the following strings:
[%SERIE%]: Displays the series label (defined with the <Chart>.SeriesLabel function)..
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
[%X%]: Displays abscissa (first series)
[%Y%]: Displays ordinate (second series)
[%Z%]: Displays the value of the third series.
The default format is: "([%X%];[%Y%]): [%Z%]"+RC+"[%CATEGORY%]" | New in version 2025grFormatBubbleInternalWindow | Displays the tooltip as an internal window | Character string corresponding to the name of the internal window (enclosed in quotation marks) used to customize the bubble associated with the chart.
Characteristics of internal window: - The bubble is displayed only. It is not possible to interact with internal window fields.
- Internal window prototype:
PROCEDURE MyWindow(FieldGraph is Field,
IndexSeries is an integer, Index is an integer,
Value is a real, BallLabel is a string)
Example: grTooltip(GRF_Ventes, grTooltipFormatInternalWindow, "FI_BullePersonnalisée")
| | grTooltipFormatScatter | Defines the tooltip format in a Scatter chart. | Character string- Empty string to use the default format.
- Combination of the following strings:
[%SERIE%]: Displays the series label (defined with the <Chart>.SeriesLabel function)..
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
[%X%]: Displays the abscissa.
The default format is "[%X%]"+RC+"[%Y%]"+RC+"[%SERIE%]"+RC+"[%CATEGORIE%]" | | grTooltipFormatHeatMap | Defines the tooltip format in a Heatmap chart. | Character string- Empty string to use the default format.
- Combination of the following strings:
[%SERIE%]: Displays the series label (defined with the <Chart>.SeriesLabel function)..
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
[%X%]: Displays abscissa (first series)
[%Y%]: Displays ordinate (second series)
[%Z%]: Displays the value of the third series.
The default format is: "([%X%];[%Y%]): [%Z%]"+RC+"[%CATEGORY%]" | | grTooltipFormatPie | Defines the tooltip format in a Pie chart. | Character string
- Empty string to use the default format.
- Combination of the following strings:
[%SERIE%]: Displays the series label (defined with the <Chart>.SeriesLabel function)..
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
[%VALUE%]: Displays the value
[%%%]: Displays the percentage
Exemple: "[%VALEUR%]"+RC+"[%CATEGORIE%]"+RC+"[%%%]"
The default format is "[%CATEGORY%]"+RC+"[%VALUE%]"+RC+"[%%%]" | | grTooltipFormatWaffle | Defines the tooltip format in a Waffle chart. | Character string
- Empty string to use the default format.
- Combination of the following strings:
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
[%VALUE%]: Displays the value
[%%%]: Displays the percentage
Example: "[%VALUE%]"+CR+"[%CATEGORY%]"+CR+"[%%%]"
The default format is "[%CATEGORY%]"+RC+"[%VALUE%]"+RC+"[%%%]" | | grTooltipFormatRangeArea | Defines the tooltip format in a Range Area chart. | Character string
- Empty string to use the default format.
- Combination of the following strings:
[%DEBUT%]: Displays interval start value.
[%FIN%]: Displays end of interval value.
[%CATEGORY%]: Displays the category label (defined with the <Chart>.CategoryLabel function)..
Example: "[%OPEN%]"+CR+"[%CLOSE%]"+CR+"[%CATEGORY%]"
The default format is: "[%DEBUT%]"+RC+"[%FIN%] |
If the default format is used: Warning: A compilation error may occur If you use dynamic string construction (option "Allow "[% %]" in strings" in the "Compilation" tab of the project description), a compilation error may appear (unknown identifier). In this case, each string must be preceded by '-%'. Example:
GRF_Echéance.Bulle(grTooltipFormat, "[%CATEGORIE%]" + CR + CR+ "[%VALEUR%]" + " H")
GRF_Echéance.Bulle(grTooltipFormat, -%"[%CATEGORIE%]" + CR + CR + -%"[%VALEUR%]" + " H")
Enabling/Disabling the tooltip The tooltip activation/deactivation ( grShowTooltip constant) takes effect only when <Chart>.Draw is executed. Formatting the elements displayed in the tooltip To format the values displayed in the tooltip (value and percentage), use <Chart>.Mask.
Related Examples:
|
Training (WINDEV): WD Chart
[ + ] This example presents the different uses of the Chart control. Different types of charts are presented: - Pie - Sunburst - Line - Scatter - Column - Area - etc. The main features presented here are the possibility to customize of charts from the code, as well as to fill the chart from an HFSQL data file, or in the editor.
|
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|