grZoom (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

Restoring the default values

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	..XAxisMax is used to find out the upper bound on the X axis for a Chart control. 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	..XAxisMin is used to find out the lower bound on the X axis for a Chart control. 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	..YAxisMax is used to find out the upper bound on the Y axis for 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	..YAxisMin is used to find out the lower bound on the Y axis for a Chart control.
Versions 18 and later ZAxisMax New in version 18 ZAxisMax ZAxisMax	..ZAxisMax is used to find out the upper bound of altitudes (Z axis) for a Chart control (Surface chart).
Versions 18 and later ZAxisMin New in version 18 ZAxisMin ZAxisMin	..ZAxisMin is used to find out the lower bound of altitudes (Z axis) for 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, 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