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

Managing the zoom

See also

ComparativePositionSeries

gr3DSParameter

grAddData

grAddTimeData

grAutoRefreshCategoryLabel

grComparativeSeriesPosition

grDonutHolePercentage

grScatter3DAltitudeColor

grScatter3DDeleteAltitudeColor

grScatter3DDeleteMarkCaption

grScatter3DGridlines

grScatter3DLinkPoint

grScatter3DMarkCaption

grScatter3DProjection

grSeriesSecondaryAxis

grSeriesType

grSmoothing

grSourceCategoryLabel

grSunburstRootSection

grSunburstSectionColor

grSunburstStartAngle

grSurfaceAddData

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 popup menu of 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>: 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.
Only the 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:
grXCoordinate
(default value) X axis (horizontal axis).
grYCoordinate Y axis (vertical axis).
grSecondaryYCoordinate Secondary 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 Property AxisXMax allows to know the maximum limit of the abscissas (X axis) of an control of type Graph. This property can be used in the zoom process of a chart to identify the section displayed.
Versions 14 and later XAxisMin New in version 14 XAxisMin XAxisMin	The Property AxisXMin allows to know the minimal bound of the abscissas (X axis) of an control of type Graph. This property can be used in the zoom process of a chart 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 zoom process of a chart 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 Property AxisZMax allows to know the maximum limit of the altitudes (Z axis) of an control of type Graph (Surface graph).
Versions 18 and later ZAxisMin New in version 18 ZAxisMin ZAxisMin	The Property AxisZMin allows to know the minimum bound of the altitudes (Z axis) of an control of type Graph (Surface graph).

For example:

// Code used to zoom
grZoom(CHART_MyChart, 5, 12, grXCoordinate)
grDraw(CHART_MyChart)

// Code used to zoom out
grZoom(CHART_MyChart, MyChart..XAxisMin, 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: wd260grf.dll