ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
  • How to retrieve the components of the color?
  • Colors of chart elements (legends, ...)
  • Colors in the charts (series, section, ...)
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
Returns and initializes the color of different chart elements.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
Example
// Modify the colors in a Chart control
grColor(CHART_Chart1, grColorLegend, LightRed)
grDraw(CHART_Chart1) // Border of the legend drawn in red
grColor(CHART_Chart1, grColorLegend, LightBlue) // The border is still red
grDraw(CHART_Chart1) // Border of the legend drawn in blue
Syntax

Finding out the color of a chart element Hide the details

<Result> = grColor(<Chart name> , <Element>)
<Result>: Integer
Color of the specified element in RGB format.
Caution: The value returned may differ according to the display configuration (resolution, ...).
<Chart name>: Control name or character string
Name of the chart to be used. This name can correspond to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
PHP Only the interactive Chart controls are available.
<Element>: Integer constant
Chart element whose color is requested. This element can correspond to one of the following constants:
grColorAxisColor of axes.
grColorAxisSideColor of raised part of axes.
AndroidPHP This constant is not available.
grColorBorderColor of border for the chart elements (for the charts other than 3D charts). Used to find out the border color for a bar in a column chart for example.
grColorBullishCandlestickColor of bars in a candlestick when the closing value is greater than the opening value.
Android This constant is not available.
grColorGridlinesGridline color.
grColorGridlinesSideColor of raised part of gridlines.
AndroidPHP This constant is not available.
grColorLegendColor of legend border.
grColorLegendBackgroundLegend background color.

Modifying the color of a chart element Hide the details

grColor(<Chart name> , <Element> [, <New color>])
<Chart name>: Control name or character string
Name of the chart to be used. This name can correspond to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
<Element>: Integer constant
Chart element whose color must be modified. This element can correspond to one of the following constants:
grColorAxisColor of axes.
grColorAxisSideColor of raised part of axes.
AndroidPHP This constant is not available.
grColorBorderColor of border for the chart elements (for the charts other than 3D charts). Used to find out the border color for a bar in a column chart for example.
grColorBullishCandlestickColor of bars in a candlestick when the closing value is greater than the opening value.
Android This constant is not available.
grColorGridlinesGridline color.
grColorGridlinesSideColor of raised part of gridlines.
AndroidPHP This constant is not available.
grColorLegendColor of legend border.
grColorLegendBackgroundLegend background color.
<New color>: Integer or constant (optional)
Color of the specified element. This color can correspond to:
Remarks

How to retrieve the components of the color?

To retrieve the components of the color returned by grColor:
  • To get the red component, use RGBRed (or perform a division modulo 256 of <Result>),
  • To get the green component, use RGBGreen (or perform a division modulo 256 of <Result>/256),
  • To get the blue component, use RGBBlue (or perform a division modulo 256 of <Result>/256/256).

Colors of chart elements (legends, ...)

  • The settings defined with grColor will be taken into account the next time grDraw is called or the next time the chart is drawn (host control is resized, context menu is modified, etc.).
  • The transparent color can only be used for the background color of the legend (grColorLegendBackground constant).
  • Printing the chart: If the white color is associated with the axes (grColorAxis constant), with the gridlines (grColorGridlines constant), with the legend (grColorLegend constant) and with the border (grColorBorder constant), the drawing will be printed in black.

Colors in the charts (series, section, ...)

  • The color of Bearish candlesticks is defined by the color of the series.
  • grSeriesColor is used to modify the color of a series.
  • grCategoryColor is used to modify the color of categories for the Pie and Color charts.
  • grScatterSeriesColor is used to initialize the color of a series in a "Scatter" chart.
  • grSunburstSectionColor is used to change the color of a section in a Sunburst chart.
  • grSurfaceAltitudeColor is used to define the color used for the altitude (Z axis) in a Surface chart.
  • grWaterfallColor indicates the color for a type of category in a Waterfall chart.
  • grHMColor is used to define the color of values in a Heatmap chart.
Component: wd290grf.dll
Minimum version required
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help