grOrigin (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | Français

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

Restoring the default values

Related examples

See also

grOrigin (Function)

In french: grOrigine

Modifies the start and end marks on one of the chart axes.

Note: grOrigin is used to view a chart section by reducing the values displayed on the one of the axes.

Versions 15 and later

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

New in version 15

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 19 and later

This function is now available for Android applications.

New in version 19

This function is now available for Android applications.

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 for PHP sites.

New in version 23

This function is now available for PHP sites.

This function is now available for PHP sites.

Example

// Modify the start and end marks on the horizontal axis
// of "MyChart". The mark will go from 5 to 12.
grOrigin("MyChart", 5, 12, grXCoordinate)
grDraw("MyChart")

// Modify the start and end marks on the vertical axis of "CHART_Chart" control
// The mark will go from 500 to 1000
// Restore the default values

// Initialize the window
gnYMin is int
gnYMax is int

// Button for modifying the mark
gnYMin = CHART_Chart..YAxisMin
gnYMax = CHART_Chart..YAxisMax
grOrigin(CHART_Chart, 500, 1000, grYCoordinate)
grDraw(CHART_Chart)

// Button for restoring the mark
grOrigin(CHART_Chart, gnYMin, gnYMax, grYCoordinate)
grDraw(CHART_Chart)

Syntax

grOrigin(<Chart name> , <Minimum mark> [, <Maximum mark> [, <Type of 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, page editor or report editor.
Only the Chart controls are available.
Only the interactive 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.

<Type of axis>: Optional constant

Axis for which the marks must be modified:
grXCoordinate
(default value) X axis (horizontal axis).
Versions 18 and later
grZCoordinate
New in version 18
grZCoordinate
grZCoordinate Z axis (Surface charts only).
This constant is not available.
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 grOrigin 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 display of the chart before the origin was modified, the minimum and maximum values of axes must be saved. 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).

Versions 20 and later

Note: grZoom can also be used to view a section of the chart. However, the final user can restore the initial configuration via the popup menu of the chart ("Initial zoom").

New in version 20

Note: grZoom can also be used to view a section of the chart. However, the final user can restore the initial configuration via the popup menu of the chart ("Initial zoom").

Related Examples:

Unit examples (WINDEV): The Chart functions

[ + ] Using the main chart designer features of WINDEV:
- Create a Pie, Column or Line chart
- Define the display area of a chart
- Define the chart options (legend, percentage, ...)
- Draw a line on a chart

Component : wd250grf.dll