grDraw (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

Creating and drawing a chart by programming

grScatter3DDeleteAltitudeColor

gr3DSParameter

grAddData

grAddTimeData

grAutoRefreshCategoryLabel

grDonutHolePercentage

grScatter3DAltitudeColor

grScatter3DDeleteMarkCaption

grScatter3DGridlines

grScatter3DLinkPoint

grScatter3DMarkCaption

grScatter3DProjection

grSeriesSecondaryAxis

grSeriesType

grSmoothing

grSourceCategoryLabel

grSunburstRootSection

grSunburstSectionColor

grSunburstStartAngle

grSurfaceAddData

grSurfaceAltitudeColor

grSurfaceDeleteAltitudeColor

grSurfaceDeleteMarkCaption

grSurfaceGetData

grSurfaceGridlines

grSurfaceMarksCaption

grWaterfallCategoryType

grWaterfallColor

grWndSize

grZoom

Creating and drawing a chart by programming
Charts and threads
Simultaneous calls

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grDraw (Function)

In french: grDessine

Draws a chart according to the specified parameters.

Notes:

grDraw takes into account the new parameters specified since the last call to this function.
This function must not be used for the Chart controls found in the report editor.

Versions 15 and later

This function is now available for the WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

New in version 15

This function is now available for the WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

This function is now available for the WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

Versions 16 and later

This function is now available for the WINDEV applications in Linux.

New in version 16

This function is now available for the WINDEV applications in Linux.

Versions 17 and later

This function is now available for the iPhone/iPad applications.

New in version 17

This function is now available for the iPhone/iPad applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 19 and later

This function is now available for the Android applications.

New in version 19

This function is now available for the Android applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Versions 23 and later

This function is now available for the PHP sites.

New in version 23

This function is now available for the PHP sites.

This function is now available for the PHP sites.

Example

// Draw a chart created by programming
grDraw("MyChart")

// Draw a chart in a Chart control
grDraw(CHART_MyChart)

Syntax

grDraw(<Chart name>)

<Chart name>: Character string (with or without quotes)

This name can correspond to:
the name of the chart to draw, defined by grCreate.
the name of Chart control (found in a window or in a page).
Only the Chart controls are available.
Only the interactive Chart controls are available.

Remarks

Creating and drawing a chart by programming

To create and draw a chart:

create the chart (grCreate),
add data (grAddData, grStockAddData and grScatterAddDataXY),
define the chart destination with the following functions:
- grDestinationBMP,
- grDestinationControl,
- grDestinationEMF,
- grDestinationWnd,
- Versions 19 and later
  grDestinationImage,
  New in version 19
  grDestinationImage,
  grDestinationImage,
- grDestinationWMF.
  Only grDestinationBMP and grDestinationControl are available.
draw the chart ( grDraw).

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.

Note: We do not advise you to call grDraw in a thread. The call to this function outside the main thread may trigger deadlocks and/or unexpected behaviors.

Simultaneous calls

grDraw is a non-locking function. If he chart is drawn with an animation, the function will give control back as soon as the animation starts. Therefore, if several charts are drawn in the same window, the controls can be animated simultaneously.

Related Examples:

Training (WINDEV): WD Chart

[ + ] This educational example present 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

The main features presented in this example are the ability to customize the charts by programming as well as the method used to fill a chart from a HFSQL file or in the editor.

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, ...)

Unit examples (WINDEV Mobile): The Chart control

[ + ] Using the Chart control to display different types of charts:
- Pie (or pie chart)
- Line
- Column chart
- Area

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, ...)

Cross-platform examples (WINDEV Mobile): WM Click on Chart

[ + ] The "WM Click on Chart" example proposes a solution for pulling out the sections of a Pie chart via a simple click.
This example includes a control template named "TPLC_PullOutChart". This control template is used to pull out the chart sections via a simple click.
To include this feature in another application, all you have to do is import the "TPLC_PullOutChart" template.

Mobile (WINDEV Mobile): Pocket Click on Chart

[ + ] The "Pocket Click on Chart" example proposes a solution for pulling out the sections of a pie chart via a simple user click.

This example includes a control template named "TPLC_PullOutChart". This control template is used to enable the pulling out of a chart section via a simple click.

To make this feature available in another application, all you have to do is import the control template named "TPLC_PullOutChart".

Component : wd240grf.dll