<Chart>.Zoom (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

Restoring the default values

AutoRefreshCategoryLabel

Scatter3DAltitudeColor

Scatter3DDeleteAltitudeColor

Scatter3DDeleteMarkCaption

SurfaceDeleteAltitudeColor

SurfaceDeleteMarkCaption

WaterfallCategoryType

WaterfallColor

Zoom

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

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Chart>.Zoom (Function)

In french: <Graphe>.Zoom

Not available

Defines the zoom of a chart.

Remark: This function is equivalent to <Chart>.Origin. However, <Chart>.Zoom allows the user to restore the initial zoom by using one of the following methods:

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.

Example

CHART_MyChart.Zoom(5, 12, grXCoordinate)
CHART_MyChart.Draw()

Syntax

<Chart control>.Zoom(<Minimum mark> [, <Maximum mark> [, <Axis>]])

<Chart control>: Control name

Name of the Chart control to use (found in the window editor).

<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 <Chart>.Graduate.
The data defined by <Chart>.Zoom will be taken into account during the next call to <Chart>.Draw.

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. This property can be used in the zoom process of a chart to identify the section displayed.
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
CHART_MyChart.Zoom(5, 12, grXCoordinate)
CHART_MyChart.Draw()

// Code used to zoom out
CHART_MyChart.Zoom(MyChart..XAxisMin, MyChart..XAxisMax, grXCoordinate)
CHART_MyChart.Draw()

Managing the zoom

<Chart>.Parameter is used to configure several options for zoom management in the Chart controls:

Managing scrollbars.
Managing the zoom out.

Component : wd250grf.dll