<Chart>.AddData (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions

Adding data
Adding data into the different types of charts

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Chart>.AddData (Function)

In french: <Graphe>.AjouteDonnée

Adds a data into a chart.

Please note For "advanced" graph types, there is a specific WLanguage function for adding data (see paragraph "Remarks").

Caution: In Linux, this function requires a specific configuration. For more details, see The charts.

Example

// Ajout d'une donnée dans le champ "GRF_MonGraphe". 
// Cette donnée de valeur 10, est ajoutée à la fin de la première série.
GRF_MonGraphe.AjouteDonnée(1, 10)

// Courbe de 9 valeurs : si l'option "Dessin des valeurs manquantes" correspond à "Non dessinées", 
// seul le point 3 n'est pas dessiné, les points 8 et 9 sont dessinés (à zéro)
GRF_MonGraphe.AjouteDonnée(1, 1, 50)
GRF_MonGraphe.AjouteDonnée(1, 2, 30)
GRF_MonGraphe.AjouteDonnée(1, 3, 30) // pas dessiné
GRF_MonGraphe.AjouteDonnée(1, 4, 30)
GRF_MonGraphe.AjouteDonnée(1, 5, 60)
GRF_MonGraphe.AjouteDonnée(1, 6, 60)
GRF_MonGraphe.AjouteDonnée(1, 7, 0) // dessiné dans tous les cas,
GRF_MonGraphe.AjouteDonnée(1, 8, Null) // dessiné dans tous les cas,
GRF_MonGraphe.AjouteDonnée(1, 9, 60) 
GRF_MonGraphe.Dessine()

Syntax

<Chart control>.AddData(<Series number> [, <Index>] , <Value>)

<Chart control>: Control name

Name of the Chart control to use (in the window, page or report editor).
Only interactive Chart controls are available.

<Series number>: Integer

Number of the series into which a value will be added.
For example, if the Chart control displays 2 lines, this is used to identify the line for which the data must be added.
If the specified number does not exist, the series between the last existing series and the specified number are automatically created and initialized to 0.

<Index>: Optional integer

Index of the data in the series into which a value must be added.
For example, for a Line chart, this parameter corresponds to the X-axis of the value to add.
If this parameter:
is not specified, the value is added at the end of the series.
is specified, the former value is replaced.
The index of the data in the series must be a strictly positive integer.

<Value>: Integer or real

Value to add.
For example, for a Line chart, this parameter corresponds to the Y-axis of the value to add.

Remarks

Adding data

The data added by <Chart>.AddData will be taken into account during the next call to <Chart>.Draw.
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 Scatter charts, it is recommended to use <Chart>.ScatterAddDataXY.
For stock charts, it is recommended to use <Chart>.StockAddData.
For Heatmap charts, it is recommended to use <Chart>.HMAddData.
For Sunburst charts, it is recommended to use <Chart>.SunburstAddData.
For Surface charts, it is recommended to use <Chart>.SurfaceAddData.
For Radial Bar charts, it is recommended to use <Chart>.RBAddData.
To add a value to the data in a chart, use <Chart>.IncreaseData.

Business / UI classification: Neutral code

Component: wd310grf.dll