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

X and Y positions
Column chart

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grInfoXY (Function)

In french: grInfoXY

Returns information about the series found at a specific chart point. This information is identical to the one displayed in the tooltip.

Remark: This function is not available for the 3D charts and for the Surface charts.

Example

Syntax

<Result> = grInfoXY(<Chart name> , <Type of information> [, <X> , <Y>])

<Result>: Integer or real

Requested information.
If no chart element is found under the mouse,
-1 (grSeries and grCategory constants)
0 (grValueXXXX constant).

<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 or page editor).

<Type of information>: Constant

Requested type of information:
grCategory Number of pointed category.
Versions 23 and later
grTheoreticalCategory
New in version 23
grTheoreticalCategory
grTheoreticalCategory Number of the category that corresponds to a pointed X coordinate (regardless of the series) and even if the cursor is not on the chart drawing.
Versions 20 and later
grPath
New in version 20
grPath
grPath Path of section in the Sunburst chart.
Versions 22 and later
grXCoord
New in version 22
grXCoord
grXCoord X coordinate of chart point.
Versions 22 and later
grYCoord
New in version 22
grYCoord
grYCoord Y coordinate of chart point.
Versions 22 and later
grSecondaryYCoord
New in version 22
grSecondaryYCoord
grSecondaryYCoord Y coordinate according to the secondary axis of chart point.
grSeries Series number.
Remark: There is one series on 4 or on 2 for the Stock charts and for the Scatter charts.
grValue Value of series.
grStartValue Start value of the series for a Stock chart.
grEndValue End value of the series for a Stock chart.
grMaxValue Maximum value of the series for a Stock chart.
grMinValue Minimum value of the series for a Stock chart.
grXValue X value of series for a Scatter chart.
grYValue Y value of series for a Scatter chart.

<X>: Optional integer

X coordinate (in pixels) to study. This coordinate is expressed in relation to the control.
If this parameter is not specified, the position used during the last call to grInfoXY is taken into account.

<Y>: Optional integer

Y coordinate (in pixels) to study. This coordinate is expressed in relation to the control.
If this parameter is not specified, the position used during the last call to grInfoXY is taken into account.

Remarks

X and Y positions

The <X> and <Y> parameters must be specified at least once.

A WLanguage error occurs if the chart has changed between 2 calls to grInfoXY and if the X and Y positions are not specified.

Column chart

When clicking a bar of the column chart, the area taken into account will be a little bit larger (at the top and at the bottom).

Related Examples:

Unit examples (WINDEV): The Chart control (click management)

[ + ] Customizing the click on a Pie chart.
Here, the section clicked by the user is pulled out by the application.
To implement this behavior, all you have to do is use grInfoXY (to identify the section clicked) and grPiePullOut (to pull out the section).

Cross-platform examples (WINDEV Mobile): WM Click on Chart

[ + ] The "WM Click on Chart" example proposes a solution for pulling out the sections of a Pie chart via a simple click.
This example includes a control template named "TPLC_PullOutChart". This control template is used to pull out the chart sections via a simple click.
To include this feature in another application, all you have to do is import the "TPLC_PullOutChart" template.

Mobile (WINDEV Mobile): Pocket Click on Chart

[ + ] The "Pocket Click on Chart" example proposes a solution for pulling out the sections of a pie chart via a simple user click.

This example includes a control template named "TPLC_PullOutChart". This control template is used to enable the pulling out of a chart section via a simple click.

To make this feature available in another application, all you have to do is import the control template named "TPLC_PullOutChart".

Component : wd250grf.dll