<Chart>.TimeLevelMax (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Chart>.TimeLevelMax (Function)

In french: <Graphe>.NiveauTemporelMax

Defines the number of levels to display in the time scale of a chart as well as the maximum level.

Note: This function can be used in conjunction with <Chart>.TimeLevelMask to define a mask for one level of the graph's time scale..

Example

// The maximum number ol fevels to display is set to 2
CHART_MyChart.TimeLevelMax(2)

// Forbids the display of years for CHART_MyChart
CHART_MyChart.TimeLevelMax(3, grtlMonth)

// Définition de l'échelle temporelle pour afficher plusieurs valeur par mois
// mais en affichant uniquement les mois dans l'échelle 
// (les jours ne sont pas affichés)
GRF_MonGraphe.NiveauTemporelMasque(grtlMonth, "Mmm")
GRF_MonGraphe.NiveauTemporelMax(1, grtlMonth)

Syntax

<Chart control>.TimeLevelMax(<Number of levels> [, <Maximum level>])

<Chart control>: Control name

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

<Number of levels>: Integer

Maximum number of levels displayed in the chart.

<Maximum level>: Optional Integer constant

Maximum level to display:
grtlDay Maximum level displayed: days.
grtlHour Maximum level displayed: hours.
grtlMillisecond Maximum level displayed: milliseconds.
grtlMinute Maximum level displayed: minutes.
grtlMonth Maximum level displayed: months.
grtlSecond Maximum level displayed: seconds.
grtlYear Maximum level displayed: years.

Remarks

When displaying a time scale on DateTime data, the chart designer draws several levels corresponding to the different time units displayed.

The minimum level to display is defined according to the range of data.
The maximum level is defined by using two parameters:
- Maximum number of levels to be displayed in the graph (default: 3).
- The maximum level allowed for display (default: year).

<Chart>.TimeLevelMax is used to modify these parameters. This allows you not to overload the chart or not to display some levels without relevance for the data displayed.

For example:

to avoid displaying the years, all you have to do is set the maximum level with the grtlMonth constant.
to avoid displaying more than two time levels in the chart, all you have to do is set the <Number of Levels> parameter to 2.

Component: wd300grf.dll