PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

This content has been translated automatically. Click here to view the French version.
  • 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.
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 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.
Example
// Création d'un histogramme
// (avec sauvegarde des paramètres modifiés par l'utilisateur)
grCreate("MonGraphe", 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.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSAreaDepth3D chart of areas shown one behind the other.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSLine3D line chart.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSCylinderColStacked3D stacked bar chart.
The bars are represented by cylinders.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSCylinderColClustered3D clustered column chart
The bars are represented by cylinders.
Universal 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.
Universal 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 the negative values.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSColumnClustered3D clustered column chart.
The bars are represented by 3D rectangles.
Universal 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.
Universal 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
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSScatter3D Scatter chart.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
gr3DSPie3D Pie chart.
Universal 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).
Versions 27 and later
grRadialBar
New in version 27
grRadialBar
grRadialBar
Circular Diagram type graph of progress.
Universal 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.
Versions 17 and later
grFunnel
New in version 17
grFunnel
grFunnel
Funnel chart. See example of Funnel chart.
Universal Windows 10 App This constant is not available.
Versions 16 and later
grBubbleChart
New in version 16
grBubbleChart
grBubbleChart
Bubble chart (see example of bubble chart).
Versions 21 and later
grHeatMap
New in version 21
grHeatMap
grHeatMap
Heatmap 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 the 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).
Versions 23 and later
grScatter3D
New in version 23
grScatter3D
grScatter3D
3D Scatter chart (see example of 3D Scatter chart).
Versions 24 and later
grPyramid
New in version 24
grPyramid
grPyramid
Pyramid chart (see example of a Pyramid chart).
grRadarRadar chart (see example of Radar chart).
grPieSector or pie chart (see example of Pie chart).
Versions 20 and later
grSunburst
New in version 20
grSunburst
grSunburst
Sunburst chart. See example of Sunburst chart.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
Versions 18 and later
grSurface
New in version 18
grSurface
grSurface
Surface chart (see example of Surface chart).
Universal Windows 10 App This constant is not available.
Versions 19 and later
grWaterfall
New in version 19
grWaterfall
grWaterfall
Waterfall chart (see example of Waterfall chart).
Versions 26 and later
grRangeArea
New in version 26
grRangeArea
grRangeArea
interval's area graph (see example of an interval zone graph).

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 graph exists in the thread which contains the function call 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