ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
  • Creating and drawing a chart through programming
  • Drawing several charts at the same time
  • Charts and threads
  • Default values of a chart created through programming
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Creates a specific type of chart.
Remarks:
  • It is recommended to create a Chart control directly rather than using grCreate. Indeed, the Chart control offers many more features.
  • This function can only be used to create a chart through programming. This function cannot be used in the window editor, page editor or report editor.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
Example
// Create a column chart
// (and save the parameters modified by the user)
grCreate("MyChart", grColumn)
Syntax
grCreate(<Chart name> , <Chart type> [, <Persistence>])
<Chart name>: Character string
Name of chart to create. This name will be used by all functions for chart management. Caution: this name must not correspond to the name of a Chart control.
<Chart type>: Constant
Specifies the type of chart to create:
gr3DSAreaStacked3D chart of stacked areas.
WEBDEV - Server code This constant is not available.
gr3DSAreaDepth3D chart of areas shown one behind the other.
WEBDEV - Server code This constant is not available.
gr3DSLine3D line chart.
WEBDEV - Server code This constant is not available.
gr3DSCylinderColStacked3D stacked bar chart.
The bars are represented by cylinders.
WEBDEV - Server code This constant is not available.
gr3DSCylinderColClustered3D clustered column chart
The bars are represented by cylinders.
WEBDEV - Server code This constant is not available.
gr3DSCylinderColDepth3D column chart in depth: the series are represented in perspective.
The bars are represented by cylinders.
WEBDEV - Server code This constant is not available.
gr3DSColumnStacked3D stacked bar chart.
The bars are represented by 3D rectangles. This type of chart does not support negative values.
WEBDEV - Server code This constant is not available.
gr3DSColumnClustered3D clustered column chart.
The bars are represented by 3D rectangles.
WEBDEV - Server code This constant is not available.
gr3DSColumnDepth3D column chart in depth: the series are represented in perspective.
The bars are represented by 3D rectangles.
WEBDEV - Server code This constant is not available.
gr3DSMinMax3D Stock chart displaying the difference between the minimum stock value and the maximum stock value
WEBDEV - Server code This constant is not available.
gr3DSScatter3D Scatter chart.
WEBDEV - Server code This constant is not available.
gr3DSPie3D Pie chart.
WEBDEV - Server code This constant is not available.
grAreaArea chart (see example of Area chart).
grPolarAreaPolar Area chart (see example of Polar Area chart).
grBarChartsStock chart (see example of Stock chart).
grCandlestickCandlestick stock chart (see example of Stock chart).
grRadialBarRadial Bar chart.
WEBDEV - Server codeLinux This constant is not available.
grLineLine chart (see example of Line chart).
grDonutDonut chart. See example of Donut chart.
grFunnelFunnel chart. See example of Funnel chart.
grBubbleChartBubble chart (see example of bubble chart).
grHeatMapHeatmap chart (see example of Heatmap chart).
grSemiCircularSemi-circular chart (see example of Semi-circular chart).
grColumnColumn chart (see example of Column chart).
grColumnStackedStacked Column chart. This type of chart does not support negative values.
grMinMaxStock chart displaying the difference between the minimum stock value and the maximum stock value (see example of Stock chart)
grScatterScatter chart (see example of Scatter chart).
grScatter3D3D Scatter chart (see example of 3D Scatter chart).
grPyramidPyramid chart (see example of Pyramid chart).
grRadarRadar chart (see example of Radar chart).
grPiePie chart (see example of Pie chart).
grSunburstSunburst chart. See example of Sunburst chart.
grSurfaceSurface chart (see example of Surface chart).
WEBDEV - Server codeLinux This constant is not available.
New in version 2024
grWaffleChart
Waffle chart (see example of Waffle chart).
grWaterfallWaterfall chart (see example of Waterfall chart).
grRangeAreaRange Area chart (see example of Range Area chart).

The type of chart can be modified later by grType.
<Persistence>: Optional boolean
  • True (default value) to save the modifications made to the chart by the user via the popup menu,
  • False not to save these modifications.
Remarks

Creating and drawing a chart through programming

To create and draw a chart:

Drawing several charts at the same time

Several charts with the same name cannot exist at the same time.
To draw several charts at the same time (in one or more windows for example), different chart names must be specified.

Charts and threads

A single chart can be handled in a thread.
Consequences:
  • Two threads cannot handle the same chart.
  • A chart created in a thread is automatically destroyed at the end of this thread. The chart exists in the thread that contains the call to grCreate.

Default values of a chart created through programming

The default values of a chart are as follows:
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
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, ...)
Business / UI classification: Neutral code
Component: wd290grf.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 12/20/2023

Send a report | Local help