ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
  • Marks on axes
  • Types of charts
  • Restoring the default values
  • Managing the zoom
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
Defines the zoom of a chart.
Remark: This function is equivalent to grOrigin. However, grZoom allows the user to restore the initial zoom by using one of the following methods:
  • WINDEV via the context menu of the chart ("Initial zoom").
  • WINDEV via the Ctrl + 0 keys.
  • AndroidiPhone/iPadIOS WidgetMac Catalyst via a double tap on the chart.
Example
grZoom(CHART_MyChart, 5, 12, grXCoordinate)
grDraw(CHART_MyChart)
Syntax
grZoom(<Chart name> , <Minimum mark> [, <Maximum mark> [, <Axis>]])
<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 editor.
Android Only Chart controls are available.
<Minimum mark>: Real
Start mark on the specified axis. This parameter can also correspond to a duration, a date, a time or a date-time.
<Maximum mark>: Optional real
End mark on the specified axis.
If this parameter is not specified, <Maximum mark> corresponds to the maximum value of chart data. This parameter can also correspond to a duration, a date, a time or a date-time.
<Axis>: Optional Integer constant
Axis for which the marks must be modified:
grSecondaryYCoordinateSecondary Y-axis (vertical axis).
grXCoordinate
(default value)
X-axis (horizontal axis).
grYCoordinateY-axis (vertical axis).
Remarks

Marks on axes

  • X-axis (horizontal axis): <Maximum mark> and <Minimum mark> correspond to the maximum and minimum data values in the series displayed.
  • Y-axis (vertical axis): <Minimum mark> and <Maximum mark> correspond to the minimum and maximum data values.
  • Limits: 100 marks above and 100 marks below the X axis.
  • To modify the frequency of marks on the horizontal or vertical axis of a chart, use grInterval.
  • The data defined by grZoom will be taken into account during the next call to grDraw.

Types of charts

The marks on axes have no effect on the Pie charts.

Restoring the default values

To restore the chart display before the zoom, the minimum and maximum values of axes must be used. These values can be known via the following properties:
XAxisMaxThe XAxisMax property gets the maximum value of the X-axis in a Chart control. This property can be used in the "Zoom" event of a Chart control to identify the section displayed.
XAxisMinThe XAxisMin property gets the minimum value of the X-axis in a Chart control. This property can be used in the "Zoom" event of a Chart control to identify the section displayed.
YAxisMaxThe YAxisMax property gets the maximum value of the Y-axis in a Chart control. This property can be used in the "Zoom" event of a Chart control to identify the section displayed.
YAxisMinThe YAxisMin property gets the minimum value of the Y-axis in a Chart control.
ZAxisMaxThe ZAxisMax property gets the maximum value of the Z-axis in a Chart control (Surface chart).
ZAxisMinThe ZAxisMin property gets the minimum value of the Z-axis in a Chart control (Surface chart).
For example:
// Code used to zoom
grZoom(CHART_MyChart, 5, 12, grXCoordinate)
grDraw(CHART_MyChart)
// Code used to zoom out
grZoom(CHART_MyChart, CHART_MyChart.XAxisMin, CHART_MyChart.XAxisMax, grXCoordinate)
grDraw(CHART_MyChart)

Managing the zoom

grParameter is used to configure several options for zoom management in the Chart controls:
  • Managing scrollbars.
  • Managing the zoom out.
Component: wd290grf.dll
Minimum version required
  • Version 20
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help