<Chart>.ScatterAddDataXY (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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 into a Scatter chart
Adding data into a chart
Equivalence

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Chart>.ScatterAddDataXY (Function)

In french: <Graphe>.NuageAjouteDonnéeXY

Adds a data into a "Scatter" chart.

Reminder By default, a graph has no data.

New in SaaS

This function is now available for Android applications.

Note: This feature is only available from WINDEV Suite SaaS 2025 - Update 2. For more details, see Using new features exclusive to WINDEV Suite SaaS 2025.

Example

// Ajoute une donnée dans le champ GRF_MonGraphe de type "Nuage de points".
// Cette valeur (20, 10) est ajoutée à la fin de la première série.
GRF_MonGraphe.NuageAjouteDonnéeXY(1, 20, 10)

Syntax

<Chart control>.ScatterAddDataXY(<Series number> [, <Subscript>] , <X value> , <Y value>)

<Chart control>: Control name

Name of the Chart control to use (in the window, page or report editor).

<Series number>: Integer

Number of the series in which a point must be initialized. 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

Index of the data to initialize in the series. If this parameter is not specified, the value is added at the end of the series.

<X value>: Real

Horizontal coordinate (X-coordinate) of the point to add.

<Y value>: Real

Vertical coordinate (Y-coordinate) of the point to add.

Remarks

Adding data into a Scatter chart

The data defined by <Chart>.ScatterAddDataXY will be taken into account during the next call to <Chart>.Draw.

Adding data into a chart

<Chart>.AddData is used to add data into a chart (pie, column, ...)

Depending on the type of chart, specific functions can also be used to add data:

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.

Reminder: To add a value to a data item on a graph, use the <Chart>.IncreaseData function.

Equivalence

We recommend that you use <Chart>.ScatterAddDataXY to add data into the "Scatter" charts. However, you can also use <Chart>.AddData.

The following syntax:

GRF_MonGraphe.NuageAjouteDonnéeXY(i, 1, 10, 20)

est is equivalent to the syntax:

GRF_MonGraphe.AjouteDonnée(i*2-1, 1, 10)
GRF_MonGraphe.AjouteDonnée(i*2, 1, 20)

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.

Component: wd300grf.dll