ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
  • Chart parameters
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 chart parameter.
Remarks:
  • This function proposes all the options of <Chart>.Parameter3DS.
  • This function must not be used on the Chart controls found in the report editor.
Example
// Disables the optimization of marks on the X-axis of CHART_Chart1
CHART_Chart1.Parameter(grOptimizedMarksX, False)
Syntax

Retrieving the value of a chart parameter Hide the details

<Result> = <Chart control>.Parameter(<Parameter>)
<Result>: Integer, real or boolean
Parameter value. The type depends on the specified parameter (see the notes).
<Chart control>: Control name
Name of the Chart control to use (in the window or page editor).
<Parameter>: Integer constant
Chart 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
gr3DSPropDistanceChart zoom
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
grAlgoFunnelMode for representing the data in a Funnel chart.
Universal Windows 10 App This constant is not available.
grAlgoPyramidMode for representing the data in a Pyramid chart.
iPhone/iPadIOS WidgetMac Catalyst This constant is only available in WINDEV applications for Windows and Linux and in applications for iPhone or iPad.
grHMDisplayColorMode for displaying colors in a Heatmap chart.
grInfiniteZoomOutEnable the infinite zoom out mode. If the infinite zoom out is enabled, you have the ability to unzoom a chart even if this one is displayed at 100%.
grInteractiveSunburstEnable the interactive mode in a Sunburst chart.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
grOptimizedLocationEnable the optimization used to populate the available space for the Pie, Semi-circular and Donut charts displayed in a control or in a window.
grOptimizedMarksXEnable the optimization of marks on the horizontal axis (X axis).
grOptimizedMarksYEnable the optimization of marks on the vertical axis (Y axis).
grProjection3DScatterMode for displaying the projections on a 3D Scatter chart.
grSamplingEnabledManagement of downsampling.
grScrollbarZoomAlwaysVisibleManagement of scrollbars during a zoom on the chart.
grSunburstCaptionPerpendicularSectionMode for displaying the caption of the section in a Sunburst chart.
grSunburstMaxLevelMaximum number of levels displayed in a Sunburst chart.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.

Modifying the value of a chart parameter Hide the details

<Chart control>.Parameter(<Parameter> , <Value>)
<Chart control>: Control name
Name of the Chart control to use (found in the window editor or the page editor).
<Parameter>: Integer constant
Chart 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.
gr3DSPropDistanceChart zoom
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.
grAlgoFunnelMode for representing the data in a Funnel chart.
Universal Windows 10 App This constant is not available.
grAlgoPyramidMode for representing the data in a Pyramid chart.
iPhone/iPadIOS WidgetMac Catalyst This constant is only available in WINDEV applications for Windows and Linux and in applications for iPhone or iPad.
grHMDisplayColorMode for displaying colors in a Heatmap chart.
grInfiniteZoomOutEnable the infinite zoom out mode. If the infinite zoom out is enabled, you have the ability to unzoom a chart even if this one is displayed at 100%.
grInteractiveSunburstEnable the interactive mode in a Sunburst chart.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
grOptimizedLocationEnable the optimization used to populate the available space for the Pie, Semi-circular and Donut charts displayed in a control or in a window.
grOptimizedMarksXEnable the optimization of marks on the horizontal axis (X axis).
grOptimizedMarksYEnable the optimization of marks on the vertical axis (Y axis).
grProjection3DScatterMode for displaying the projections on a 3D Scatter chart.
grSamplingEnabledManagement of downsampling.
grScrollbarZoomAlwaysVisibleManagement of scrollbars during a zoom on the chart.
grSunburstCaptionPerpendicularSectionMode for displaying the caption of the section in a Sunburst chart.
grSunburstMaxLevelMaximum number of levels displayed in a Sunburst chart.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst This constant is not available.
<Value>: Integer, real or boolean
Parameter value. The type depends on the specified parameter (see the notes).
Remarks

Chart parameters

The different chart parameters are as follows:
ConstantEffectParameter value
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
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
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
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 chartBoolean.
  • True if the legend and title overlap 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 chart.Real
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 sectionsInteger
The possible values are included between 0 (opaque) and 100 (transparent/invisible).
The default value is 27%.
grAlgoFunnelMode for representing the data in a Funnel chart.Integer constant:
  • grFunnelArea: The value is symbolized by the area of funnel section.
  • grFunnelHeight: The value is symbolized by the height of funnel section.
grAlgoPyramidMode for representing the data in a Pyramid chart.Integer constant:
  • grPyramidHeight: The value is symbolized by the height of the pyramid section.
  • grPyramidVolume: The value is symbolized by the volume of the pyramid section.
grHMDisplayColorMode for displaying colors between two values in a Heatmap chart. The possible values are:
  • grColorGradient (by default): A linear gradient is applied to the intermediate values.
  • grLowerLevel: The display of colors is done by level. All the values less than or equal to the level will take the color given by <Chart>.HMColor.
  • grHigherLevel: The display of colors is done by level. All the values greater than or equal to the level will take the color given by <Chart>.HMColor.
grInfiniteZoomOutManagement of zoom out (unzoom)Boolean.
  • True to allow the zoom out in a chart (which means to use a negative zoom when the chart is displayed at 100%)
  • False (by default) to forbid the zoom out.
grInteractiveSunburstMode for managing the interactivity of Sunburst chart. Boolean.
  • True (default option): the Sunburst chart is interactive: a click on a section is used to display the sections of sub-levels.
  • False: the Sunburst chart is not interactive.
grOptimizedLocationEnable the optimization used to populate the available space for the Pie, Semi-circular and Donut charts displayed in a control or in a window.Boolean.
If the optimization of the fill is enabled, the Pie, Semi-circular and Donut charts will occupy the entire available space when they are displayed in a control or in a window.
The optimization of the fill is enabled by default.
grOptimizedMarksXEnable the optimization of marks on the horizontal axis (X axis).Boolean.
If the optimization of marks is enabled, only some marks are displayed to avoid the overlapping effects.
Marks are optimized by default ("Mark" option set to "Default" in the Chart control description window).
grOptimizedMarksYEnable the optimization of marks on the vertical axis (Y axis).Boolean.
If the optimization of marks is enabled, only some marks are displayed to avoid the overlapping effects.
Marks are optimized by default ("Mark" option set to "Default" in the Chart control description window).
grProjection3DScatterMode for displaying the projections on a 3D Scatter chart.The projections have been defined by <Chart>.Scatter3DProjection.
The possible values are:
  • grProjectionNone: No projection is performed.
  • grProjectionClick: The projections are visible during the click on the point.
  • grProjectionAlwaysVisible (by default): These projections are always visible.
grSamplingEnabledManagement of data sampling. Boolean.
  • True if the data sampling is enabled.
  • False if the data sampling is disabled.
grScrollbarZoomAlwaysVisibleManagement of scrollbars during a zoom. Boolean.
  • True (by default) if the zoom scrollbars must always be visible, even when the chart is displayed at 100%.
  • False if the zoom scrollbars must become invisible when the chart is displayed at 100%.
grSunburstCaptionPerpendicularSectionEnable the display of captions perpendicular to sections.Boolean.
By default, labels are displayed in a circular orientation. If this option is enabled (True), the label will be displayed in a circular orientation.
grSunburstMaxLevelMaximum number of levels displayed in a Sunburst chart. Integer.
Default value: 0 (corresponds to no limit).
Related Examples:
WD Chart Training (WINDEV): WD Chart
[ + ] This example presents the different uses of the Chart control.
Different types of charts are presented:
- Pie
- Sunburst
- Line
- Scatter
- Column
- Area
- etc.

The main features presented here are the possibility to customize of charts from the code, as well as to fill the chart from an HFSQL data file, or in the editor.
Component: wd290grf.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help