ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
  • Drawing parameter
  • Miscellaneous
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Retrieves or modifies a parameter for drawing a chart in 3D Spatial mode.
Remarks:
  • This function must not be used on the Chart controls found in the report editor.
  • This function is equivalent to grParameter.
Example
// Modify the type of animation played when
// displaying "CHART_MyChart"
// The bars will be built progressively and
// the chart will appear with a rotation effect
gr3DSParameter(CHART_MyChart, gr3DSPropAnimation, 10)
Syntax

Retrieving the value of a drawing parameter Hide the details

<Result> = gr3DSParameter(<Chart name> , <Drawing parameter>)
<Result>: Integer, real or boolean
Value of the drawing parameter. The type depends on the specified drawing parameter (see the Notes).
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate,
  • the Chart control created in the window editor.
<Drawing parameter>: Integer constant
Drawing parameter whose value is requested:
gr3DSPropAnimationType of animation played when displaying the chart.
gr3DSPropAutoZoomAutomatic zoom of chart.
gr3DSPropColorPlaneXColor of vertical plane (axis to right or to left).
gr3DSPropColorPlaneYColor of horizontal plane (axis above or below).
gr3DSPropColorPlaneZColor of background plane.
gr3DSPropDistanceZoom of chart.
gr3DSPropElevationRotation angle of chart around the vertical axis (Y axis).
gr3DSPropLegendOverlapThe legend and title overlap the chart.
gr3DSPropLightXX-coordinate of the light that is lighting the chart.
gr3DSPropLightYY coordinate of the light that is lighting the chart.
gr3DSPropRotationRotation angle of chart around the horizontal axis (X axis).
gr3DSPropTransparencyTransparency level for the bars or sections of chart.

Modifying the value of a drawing parameter Hide the details

gr3DSParameter(<Chart name> , <Drawing parameter> , <Value>)
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate,
  • the Chart control created in the window editor.
<Drawing parameter>: Constant
Drawing parameter to modify:
gr3DSPropAnimationType of animation played when displaying the chart.
gr3DSPropAutoZoomAutomatic zoom of chart.
gr3DSPropColorPlaneXColor of vertical plane (axis to right or to left).
gr3DSPropColorPlaneYColor of horizontal plane (axis above or below).
gr3DSPropColorPlaneZColor of background plane.
gr3DSPropDistanceZoom of chart.
gr3DSPropElevationRotation angle of chart around the vertical axis (Y axis).
gr3DSPropLegendOverlapThe legend and title overlap the chart.
gr3DSPropLightXX-coordinate of the light that is lighting the chart.
gr3DSPropLightYY coordinate of the light that is lighting the chart.
gr3DSPropRotationRotation angle of chart around the horizontal axis (X axis).
gr3DSPropTransparencyTransparency level for the bars or sections of chart.
<Value>: Integer, real or boolean
Value of the drawing parameter. The type depends on the specified drawing parameter (see the Notes).
Remarks

Drawing parameter

The parameters for drawing a 3D spatial chart are as follows:
ConstantEffectValue of the drawing parameter
gr3DSPropAnimationType of animation played when displaying the chartInteger
The possible values are:
  • 0: no animation
  • 1: zoom in
  • 2: rotating effect
  • 4: progressive drawing of bars/sections
  • 8: progressive display of colors
These values can be added.
The default value is 15.
gr3DSPropAutoZoomAutomatic zoom of chartBoolean
True (by default) if the zoom must be automatically calculated, False otherwise.
If the zoom is automatically calculated, the value of gr3DSPropDistance constant is ignored.
gr3DSPropColorPlaneXColor of vertical plane (axis to right or to left)Integer
RGB component of the color (returned by RGB) or a preset color.
To avoid drawing this axis, use the Transparent constant.
This constant is taken into account by the bar charts and by the line charts only.
The default value is LightGray.
gr3DSPropColorPlaneYColor of horizontal plane (axis above or below)Integer
RGB component of the color (returned by RGB) or a preset color.
To avoid drawing this axis, use the Transparent constant.
This constant is taken into account by the bar charts and by the line charts only.
The default value is LightGray.
gr3DSPropColorPlaneZColor of background planeInteger
RGB component of the color (returned by RGB) or a preset color.
To avoid drawing this axis, use the Transparent constant.
This constant is taken into account by the bar charts and by the line charts only.
The default value is LightGray.
gr3DSPropDistanceChart zoomReal
The possible values are included between 0 and infinity.
This constant is taken into account only if the gr3DSPropAutoZoom constant is set to False.
The default value is 189.
gr3DSPropElevationRotation angle (in degrees) of the chart around the vertical axis (Y axis).Real
The possible values are included between 0 and 360.
The value 0 displays a frontal view of chart.
The value 90 displays the chart from above.
The best rotation angle is automatically calculated by default.
gr3DSPropLegendOverlapThe legend and title overlap the chart.Boolean
True if the legend and the title are superimposed to the chart, False (by default) otherwise.
gr3DSPropLightXX-coordinate of the light that is lighting the chart.Real
The possible values are included between 0 and infinity.
The default value is 78.
gr3DSPropLightYY-coordinate of the light that is lighting the chartReal
The possible values are included between 0 and infinity.
The default value is 80.
gr3DSPropRotationRotation angle (in degrees) of the chart around the horizontal axis (X-axis).Real
The possible values are included between 0 and 360.
The value 0 displays a frontal view of chart.
The value 90 displays a right view of chart.
The best rotation angle is automatically calculated by default.
gr3DSPropTransparencyTransparency level (in percentage) for the bars or chart sections.Integer
The possible values are included between 0 (opaque) and 100 (transparent/invisible).
The default value is 27%.

Miscellaneous

No error is returned if gr3DSParameter is used on a type of chart other than 3D Spatial. The information is stored and it will be used when the type of the chart is modified (by grType or with the context menu of the chart).
Business / UI classification: Neutral code
Component: wd290grf.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help