grAddData (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

Adding data into the different types of charts

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

Adding data
Adding data into the different types of charts

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grAddData (Function)

In french: grAjouteDonnée

Adds a data into a chart.

Caution: A specific WLanguage function must be used for the "advanced" charts (see "Remarks").

Versions 15 and later

This function is now available for 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 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 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 WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for 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 Android applications.

New in version 19

This function is now available for 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 PHP sites.

New in version 23

This function is now available for PHP sites.

This function is now available for PHP sites.

Example

// Add a data into the "CHART_MyChart" control.
// This data (whose value is 10) is added at the end of the first series.
grAddData(CHART_MyChart, 1, 10)

Syntax

grAddData(<Chart name> , <Series number> [, <Subscript>] , <Value>)

<Chart name>: Control name or character string (with quotes)

Name of chart to use. This name corresponds to:
the chart name defined by programming with grCreate. This name must be in quotation marks.
the name of Chart control (found in the window editor, page editor or report editor). This name must not be in quotation marks.
Only the Chart controls are available.
Only the interactive Chart controls are available.

<Series number>: Integer

Number of the series into which a value will be added. If the specified series does not exist, the chart designer creates as many series as necessary in order to get a consistent matrix. All the created series are initialized to 0.

<Subscript>: Optional integer

Subscript of the data in the series into which a value must be added. If this parameter:
is not specified, the value is added at the end of the series.
is specified, the former value is replaced.
The subscript of the data in the series must be strictly positive.

<Value>: Integer or real

Value to add.

Remarks

Adding data

The data added by grAddData will be taken into account during the next call to grDraw.
For a pie chart (grPie constant), only the data found in the first series is used. A Pie chart cannot be drawn if the data found in the first series is null.
For the "Stacked bar" charts, if the value of the first series is negative, the corresponding bar is oriented toward the bottom.

Adding data into the different types of charts

For the Scatter charts, we recommend that you use grScatterAddDataXY.
For the stock charts, we recommend that you use grStockAddData.
Versions 21 and later
For the Heatmap charts, we recommend that you use grHMAddData.
New in version 21
For the Heatmap charts, we recommend that you use grHMAddData.
For the Heatmap charts, we recommend that you use grHMAddData.
Versions 20 and later
For the Sunburst charts, we recommend that you use grSunburstAddData.
New in version 20
For the Sunburst charts, we recommend that you use grSunburstAddData.
For the Sunburst charts, we recommend that you use grSunburstAddData.
Versions 18 and later
For the Surface charts, we recommend that you use grSurfaceAddData.
New in version 18
For the Surface charts, we recommend that you use grSurfaceAddData.
For the Surface charts, we recommend that you use grSurfaceAddData.
To add a value to a chart data, use grIncreaseData.

Related Examples:

Training (WINDEV): WD Chart

[ + ] This example shows the 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
- Comparative

The main features presented in this example are the customization of charts by programming, as well as the method used to fill a chart from an 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, ...)

Business / UI classification : Neutral code

Component : wd250grf.dll