grDraw (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

Creating and drawing a chart by programming

Charts and threads

Related examples

See also

grScatter3DDeleteAltitudeColor

gr3DSParameter

grAddData

grAddTimeData

grAutoRefreshCategoryLabel

grComparativeSeriesPosition

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

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.

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

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.

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.

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 : wd250grf.dll