grDraw (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Chart management functions

Creating and drawing a chart by programming

Charts and threads

Related examples

See also

ComparativePositionSeries

gr3DSParameter

grAddData

grAddTimeData

grAutoRefreshCategoryLabel

grComparativeSeriesPosition

grDonutHolePercentage

grScatter3DAltitudeColor

grScatter3DDeleteAltitudeColor

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

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grDraw (Function)

In french: grDessine

Draws a chart according to the specified parameters.

Remarks:

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 23 and later

This function is now available for PHP sites.

New in version 23

This function is now available for PHP sites.

This function is now available for 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 interactive Chart controls are available.

Remarks

Creating and drawing a chart by programming

To create and draw a chart:

create the chart (grCreate),
add the data (grAddData, grStockAddData et 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.
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.

Remark: 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.

Related Examples:

Training (WINDEV): WD Chart

[ + ] This example presents the different uses of the Chart control.
Different types of charts are presented:
- Pie
- Sunburst
- Line
- Scatter
- Column
- Area
- etc.

The main features presented here are the possibility to customize of charts from the code, as well as to fill the chart from an HFSQL data 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: wd260grf.dll