<Chart>.ScatterAddDataXY (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 a Scatter chart

Adding data into a chart

AutoRefreshCategoryLabel

Scatter3DAltitudeColor

Scatter3DDeleteAltitudeColor

Scatter3DDeleteMarkCaption

SurfaceDeleteAltitudeColor

SurfaceDeleteMarkCaption

WaterfallCategoryType

WaterfallColor

Zoom

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 chart contains no data.

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

Example

// Adds a data into the CHART_MyChart control ("Scatter" chart).
// This value (20, 10) is added at the end of the first series.
CHART_MyChart.ScatterAddDataXY(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 (found in the window editor, page editor 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

Subscript 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 the stock charts, we recommend that you use <Chart>.StockAddData.
Versions 21 and later
For the Heatmap charts, we recommend that you use <Chart>.HMAddData.
New in version 21
For the Heatmap charts, we recommend that you use <Chart>.HMAddData.
For the Heatmap charts, we recommend that you use <Chart>.HMAddData.
Versions 20 and later
For the Sunburst charts, we recommend that you use <Chart>.SunburstAddData.
New in version 20
For the Sunburst charts, we recommend that you use <Chart>.SunburstAddData.
For the Sunburst charts, we recommend that you use <Chart>.SunburstAddData.
Versions 18 and later
For the Surface charts, we recommend that you use <Chart>.SurfaceAddData.
New in version 18
For the Surface charts, we recommend that you use <Chart>.SurfaceAddData.
For the Surface charts, we recommend that you use <Chart>.SurfaceAddData.

Reminder: To add a value to a chart data, use <Chart>.IncreaseData.

Equivalence

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

The following syntax:

CHART_MyChart.ScatterAddDataXY(I, 1, 10, 20)

est is equivalent to the syntax:

CHART_MyChart.AddData(i*2-1, 1, 10)
CHART_MyChart.AddData(i*2, 1, 20)

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.

Component : wd240grf.dll