PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

  • 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 codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSAreaDepth3D chart of areas shown one behind the other.
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSLine3D line chart.
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSCylinderColStacked3D stacked bar chart.
The bars are represented by cylinders.
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSCylinderColClustered3D clustered column chart
The bars are represented by cylinders.
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSCylinderColDepth3D column chart in depth: the series are represented in perspective.
The bars are represented by cylinders.
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst 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 codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSColumnClustered3D clustered column chart.
The bars are represented by 3D rectangles.
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst 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 codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSMinMax3D Stock chart displaying the difference between the minimum stock value and the maximum stock value
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSScatter3D Scatter chart.
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSPie3D Pie chart.
WEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
grAreaArea chart (see example of Area chart).
grBarChartsStock chart (see example of Stock chart).
grCandlestickCandlestick stock chart (see example of Stock chart).
New in version 27
grRadialBar
Radial Bar chart.
WEBDEV - Server codeLinuxUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
grLineLine chart (see example of Line chart).
grDonutDonut chart. See example of Donut chart.
Universal Windows 10 App This constant is not available.
grFunnelFunnel chart. See example of Funnel chart.
Universal Windows 10 App This constant is not available.
grBubbleChartBubble chart (see example of bubble chart).
grHeatMapHeatmap chart (see example of Heatmap chart).
grSemiCircularSemi-circular chart (see example of Semi-circular chart).
Universal Windows 10 App This constant is not available.
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.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
grSurfaceSurface chart (see example of Surface chart).
WEBDEV - Server codeLinuxUniversal Windows 10 App This constant is not available.
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: wd270grf.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment