Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart management functions
  • Chart caption
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Indicates various parameters of additional legend in a chart.
Example of additional legends:
Additional legends
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
// Chart created through programming
// Display the caption for the labels of data categories in "MyChart"
grLabel("MyChart", grShowLabel, True)
// Chart control
// Display the caption for the percentages of data categories in "CHART_MyChart"
grLabel(CHART_Chart, grShowPercent, True)
grLabel(<Chart name> , <Additional legend> , <Display>)
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
PHP Only the interactive Chart controls are available.
<Additional legend>: Constant
Additional legend that will be displayed with the chart:
  • with a pie chart:
    grShowLabelLabel of data categories.
    grShowPercentPercentage of data categories.
    grShowValueValue of data categories.
  • with a column chart:
    grShowValueValue of data categories.
  • with a stacked column chart:
    grShowValueIfNullLabel of data categories, even for the null values in the stacked column chart.
<Display>: Boolean
  • True if the additional legend must be displayed,
  • False otherwise.

Chart caption

The chart caption can include three elements:
  • the category labels.
  • the value of categories.
  • the percentage of categories.
Chart captions
Chart captions can only be displayed in Pie, Column and Stacked Column charts.
grLabel displays the different elements of the chart caption. Different elements are displayed according to the type of chart.
The category labels displayed correspond to the ones defined by grCategoryLabel.
The value of categories depends on the chart data.
The percentage of categories is automatically calculated.
The information display can be formatted by grMask.
The modifications performed by grLabel will be taken into account during the next call to grDraw.
Related Examples:
The Chart functions Unit examples (WINDEV): The Chart functions
[ + ] Using the main chart designer features of WINDEV:
- Create a Pie, Column or Line chart
- Define the display area of a chart
- Define the chart options (legend, percentage, ...)
- Draw a line on a chart
WD Chart 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.
The Chart functions Unit examples (WEBDEV): The Chart functions
[ + ] This example presents the main features of the chart designer of WEBDEV and it allows you to:
- Create a chart: Pie, Column or Line
- Define the display area of a chart
- Define the options of the chart (legend, percentage, ...)
The Chart functions Unit examples (WINDEV Mobile): The Chart functions
[ + ] Using the Chart functions:
- create a Pie, Column or Line chart by programming
- define the chart options (legend, percentage, ...)
Component: wd280grf.dll
Minimum version required
  • Version 9
This page is also available for…
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help