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

grScatterAddDataXY (Function)

In french: grNuageAjouteDonnéeXY

Adds a data into a "Scatter" chart.

Reminder: By default, a graph has no data.

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

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

// Adds a data into the "Scatter" chart named "MyChart".
// This value (10, 20) is added at the end of the first series.
grScatterAddDataXY("MyChart", 1, 10, 20)

// Adds a data into the CHART_MyChart control ("Scatter" chart).
// This value (20, 10) is added at the end of the first series.
grScatterAddDataXY(CHART_MyChart, 1, 20, 10)

Syntax

grScatterAddDataXY(<Chart name> , <Series number> [, <Index>] , <X value> , <Y value>)

<Chart name>: Control name or character string

Name of the chart to be used. This name corresponds to:
the name of the chart defined programmatically with grCreate.
the name of the Chart control in the window, page or report editor.
Only interactive Chart controls are available.

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

<Index>: 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 grScatterAddDataXY will be taken into account during the next call to grDraw.

Adding data into a chart

grAddData 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 grStockAddData.
For Heatmap charts, it is recommended to use grHMAddData.
For Sunburst charts, it is recommended to use grSunburstAddData.
For Surface charts, it is recommended to use grSurfaceAddData.

Reminder: To add a value to graph data, use the grIncreaseData function.

Equivalence

We recommend that you use grScatterAddDataXY to add data into the "Scatter" charts. However, you can also use grAddData.

The following syntax:

grScatterAddDataXY(CHART_MyChart, i, 1, 10, 20)

est is equivalent to the syntax:

grAddData(CHART_MyChart, i*2-1, 1, 10)
grAddData(CHART_MyChart, 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