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

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

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grScatterGetDataXY (Function)

In french: grNuageRécupèreDonnéeXY

Retrieves a data from a "Scatter" chart.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

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

// Display data in the "CHART_MyChart" control ("Scatter" chart).
// This data is the first X coordinate of first series.
Info(grScatterGetDataXY(CHART_MyChart, 1, 1, grXValue))

Syntax

<Result> = grScatterGetDataXY(<Chart name> , <Series number> , <Subscript> , <Value to retrieve>)

<Result>: Real

Retrieved value.

<Chart name>: Character string (with or without quotes)

Name of chart to use. This name corresponds to:
the chart name defined by programming with grCreate,
the name of Chart control (found in the window editor, page editor or report editor).

<Series number>: Integer

Number of the series for which a value will be retrieved.
If the specified series does not exist, the retrieved value is 0.

<Subscript>: Integer

Subscript of data in the series for which the value will be retrieved.
If the data corresponding to the specified subscript does not exist in the series, the retrieved value is 0.

<Value to retrieve>: Integer constant

Indicates the value to retrieve:
grXValue X value of series.
grYValue Y value of series.

Remarks

To retrieve data from a Stock chart, we recommend that you use grStockGetData.
To retrieve data from a Surface chart, we recommend that you use grSurfaceGetData.
To retrieve data from another type of chart (Pie, Column, Line, etc.), we recommend that you use grGetData.
To retrieve data from a Sunburst chart, we recommend that you use grSunburstGetData.
Versions 21 and later
To retrieve data from a Heatmap chart, we recommend that you use grHMGetData.
New in version 21
To retrieve data from a Heatmap chart, we recommend that you use grHMGetData.
To retrieve data from a Heatmap chart, we recommend that you use grHMGetData.
We recommend that you use grScatterGetDataXY to retrieve data from "Scatter" charts. You also have the ability to use grGetData.
The following syntax:

grScatterGetDataXY(CHART_MyChart, i, 1, grXValue)
grScatterGetDataXY(CHART_MyChart, i, 1, grYValue)

is equivalent to the syntax:

grGetData(CHART_MyChart, i*2-1, 1)
grGetData(CHART_MyChart, i*2, 1)

By default, a chart created by grCreate contains no data.

Component : wd250grf.dll