PC SOFT

ONLINE HELP
 WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Chart legend
  • Manual positioning of legend: grLegend without effect
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Indicates the presence and position of legend in a chart.
Example of legend in a chart:
Legend in a chart
Remark: The legend contains the colors and the series labels (or section labels) of a chart.
Versions 15 and later
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The charts for more details.
New in version 15
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The charts for more details.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The charts for more details.
Versions 16 and later
WINDEVLinux This function is now available for WINDEV applications in Linux.
New in version 16
WINDEVLinux This function is now available for WINDEV applications in Linux.
WINDEVLinux This function is now available for WINDEV applications in Linux.
Versions 17 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for iPhone/iPad applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 19 and later
Android This function is now available for Android applications.
New in version 19
Android This function is now available for Android applications.
Android This function is now available for Android applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 23 and later
PHP This function is now available for PHP sites.
New in version 23
PHP This function is now available for PHP sites.
PHP This function is now available for PHP sites.
Example
// Chart created by programming
grCreate("MyChart", grColumn)
grDestinationWnd("MyChart", "", "Title of the window")
// The legend is displayed on the right of "MyChart"
grLegend("MyChart", grAtRight)
...
grDraw("MyChart")
// Using a Chart control
// The legend is displayed on the left of CHART_MyChart
grLegend(CHART_MyChart, grAtLeft)
...
grDraw(CHART_MyChart)
Syntax
grLegend(<Chart name> , <Position>)
<Chart name>: Character string (with or without quotes)
Name of chart to use. This name corresponds to:
  • the chart name defined by programming with grCreate.
  • the name of Chart control found in the window editor, page editor or report editor.
Android Only the Chart controls are available.
PHP Only the interactive Chart controls are available.
<Position>: Integer
Position of chart legend:
grAtRightLegend displayed on the right of chart.
grAtLeftLegend displayed on the left of chart.
grAtBottomLegend displayed below the chart.
grAtTopChart legend displayed above the chart.
grNoneNo legend.
Remarks

Chart legend

The set of series labels correspond to the chart legend.
Labels of series
Series labels cannot be used in Pie charts.
The series labels are defined by grSeriesLabel.
The legend font can be modified by grLegendFont.
grLegend is used to indicate the existence and position of the legend (i.e. of all the series labels). The modifications performed by grLegend will be taken into account during the next call to grDraw. The position of the chart legend can be modified from a popup menu.
Remark: To define series labels in "Scatter" charts, we recommend that you use grScatterSeriesLabel. See Legends of a chart for more details.

Manual positioning of legend: grLegend without effect

grLegend has no effect if the legend is positioned manually ("Manual positioning" in the chart legend window).
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 shows the 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
- Comparative

The main features presented in this example are the customization of charts by programming, as well as the method used to fill a chart from an HFSQL 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 : wd260grf.dll
See also
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment