ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
  • X and Y positions
  • Column chart
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
Example
WINDEVWEBDEV - Server codeUniversal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst
// Code of click on a CHART_MyChart chart
Information is string = ...
"(" + MouseXPos() + "," + MouseYPos() + ")" + CR + ...
"grSeries -->" + TAB + grInfoXY(MySelf, grSeries, MouseXPos(), MouseYPos()) + CR + ...
"grCategory -->" + TAB + grInfoXY(MySelf, grCategory, ...
MouseXPos(), MouseYPos()) + CR + ...
"grValue -->" + TAB + grInfoXY(MySelf, grValue, ...
MouseXPos(), MouseYPos()) + CR + ...
"grXValue -->" + TAB + grInfoXY(MySelf, ...
MouseXPos(), MouseYPos()) + CR + ...
"grMinValue -->" + TAB + grInfoXY(MySelf, grMinValue, ...
MouseXPos(), MouseYPos()) + CR + ...
"grYValue -->" + TAB + grInfoXY(MySelf, grYValue, ...
MouseXPos(), MouseYPos()) + CR + ...
"grMaxValue -->" + TAB + grInfoXY(MySelf, grMaxValue, ...
MouseXPos(), MouseYPos()) + CR + ...
"grStartValue -->" + TAB + grInfoXY(MySelf, grStartValue, ...
MouseXPos(), MouseYPos()) + CR + ...
"grEndValue -->" + TAB + grInfoXY(MySelf, grEndValue, MouseXPos(), MouseYPos())
WEBDEV - Browser codeAndroid
// Click code on a chart
Information is string = ...
"(" + MouseXPos() + "," + MouseYPos() + ")" + CR + ...
"grSeries -->" + TAB + grInfoXY(MySelf, grSeries, MouseXPos(), MouseYPos()) + CR + ...
"grCategory -->" + TAB + grInfoXY(MySelf, grCategory, ...
MouseXPos(), MouseYPos()) + CR + ...
"grValue -->" + TAB + grInfoXY(MySelf, grValue, ...
MouseXPos(), MouseYPos()))
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>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control (in the window or page editor).
Android Only Chart controls are available.
WEBDEV - Browser code Only interactive Chart controls are available ("Interactive chart" option in the "Details" tab of the control description window).
<Type of information>: Constant
Type of information requested:
grCategoryNumber of pointed category.
grTheoreticalCategoryNumber 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.
WEBDEV - Browser codeAndroid This constant is not available.
grPathPath of section in the Sunburst chart.
WEBDEV - Server codeWEBDEV - Browser codeAndroidiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
grXCoordX-coordinate of chart point.
WEBDEV - Browser codeAndroid This constant is not available.
grYCoordY-coordinate of chart point.
WEBDEV - Browser codeAndroid This constant is not available.
grSecondaryYCoordY-coordinate according to the secondary axis of chart point.
WEBDEV - Browser codeAndroid This constant is not available.
grSeriesSeries number.
Remark: There is one series on 4 or on 2 for the Stock charts and for the Scatter charts.
grValueValue of series.
grStartValueStart value of the series for a Stock chart.
WEBDEV - Browser codeAndroid This constant is not available.
grEndValueEnd value of the series for a Stock chart.
WEBDEV - Browser codeAndroid This constant is not available.
grMaxValueMaximum value of the series for a Stock chart.
WEBDEV - Browser codeAndroid This constant is not available.
grMinValueMinimum value of the series for a Stock chart.
WEBDEV - Browser codeAndroid This constant is not available.
grXValueX value of series for a Scatter chart.
WEBDEV - Browser codeAndroid This constant is not available.
grYValueY value of series for a Scatter chart.
WEBDEV - Browser codeAndroid This constant is not available.
<X>: Optional integer
X-coordinate (in pixels) to be analyzed. This coordinate is expressed in relation to the control.
If this parameter is not specified, the position used in the last call to grInfoXY is taken into account.
<Y>: Optional integer
Y-coordinate (in pixels) to be analyzed. This coordinate is expressed in relation to the control.
If this parameter is not specified, the position used in 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:
The Chart control (click management) 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).
WM Click on Chart 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.
Component: wd300grf.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help