grZoom (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Chart management functions

Restoring the default values

grAutoRefreshCategoryLabel

grComparativeSeriesPosition

grDonutHolePercentage

grRBRotationDirection

grScatter3DAltitudeColor

grScatter3DDeleteAltitudeColor

grScatter3DDeleteMarkCaption

grScatter3DGridlines

grScatter3DLinkPoint

grScatter3DMarkCaption

grScatter3DProjection

grSeriesSecondaryAxis

grSeriesType

grSmoothing

grSourceCategoryLabel (Example)

grSourceCategoryLabel

grSunburstRootSection

grSunburstSectionColor

grSunburstStartAngle

grSurfaceAddData (Example)

grSurfaceAddData

grSurfaceAltitudeColor (Example)

grSurfaceAltitudeColor

grSurfaceDeleteAltitudeColor

grSurfaceDeleteMarkCaption

grSurfaceGetData

grSurfaceGridlines

grSurfaceMarksCaption

grWaterfallCategoryType

grWaterfallColor

grWndSize

grZoom

Marks on axes
Types of charts
Restoring the default values
Managing the zoom

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grZoom (Function)

In french: grZoom

Not available

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:

via the context menu of the chart ("Initial zoom").
via the Ctrl + 0 keys.
via a double tap on the chart.

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.

Versions 23 and later

This function is now available in browser code.

New in version 23

This function is now available in browser code.

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.
Only Chart controls are available.

<Minimum mark>: Real

Start mark on the specified axis.
Versions 23 and later
This parameter can also correspond to a duration, a date, a time or a date-time.
New in version 23
This parameter can also correspond to a duration, a date, a time or a date-time.
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.
Versions 23 and later
This parameter can also correspond to a duration, a date, a time or a date-time.
New in version 23
This parameter can also correspond to a duration, a date, a time or a date-time.
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:
grSecondaryYCoordinate Secondary Y-axis (vertical axis).
grXCoordinate
(default value) X-axis (horizontal axis).
grYCoordinate Y-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 grGraduate.
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:


Versions 14 and later XAxisMax New in version 14 XAxisMax XAxisMax	The XAxisMax property is used to determine the upper bound of the X-axis in a Chart control. This property can be used in the event "Zoom" of a Chart control to identify the section displayed.
Versions 14 and later XAxisMin New in version 14 XAxisMin XAxisMin	The XAxisMin property is used to determine the lower bound of the X-axis in a Chart control. This property can be used in the event "Zoom" of a Chart control to identify the section displayed.
Versions 14 and later YAxisMax New in version 14 YAxisMax YAxisMax	The YAxisMax property is used to determine the upper bound of the Y-axis in a Chart control. This property can be used in the event "Zoom" of a Chart control to identify the section displayed.
Versions 14 and later YAxisMin New in version 14 YAxisMin YAxisMin	The YAxisMin property is used to determine the lower bound of the Y-axis in a Chart control.
Versions 18 and later ZAxisMax New in version 18 ZAxisMax ZAxisMax	The ZAxisMax property is used to determine the upper bound of the Z-axis in a Chart control (Surface chart).
Versions 18 and later ZAxisMin New in version 18 ZAxisMin ZAxisMin	The ZAxisMin property is used to determine the lower bound 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)

Versions 22 and later

Managing the zoom

grParameter is used to configure several options for zoom management in the Chart controls:

Managing scrollbars.
Managing the zoom out.

New in version 22

Managing the zoom

grParameter is used to configure several options for zoom management in the Chart controls:

Managing scrollbars.
Managing the zoom out.

Managing the zoom

grParameter is used to configure several options for zoom management in the Chart controls:

Managing scrollbars.
Managing the zoom out.

Component: wd270grf.dll