<Chart>.Color (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

How to retrieve the components of the color?

Colors of chart elements (legends, ...)

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

See also

<Chart>.Color (Function)

In french: <Graphe>.Couleur

Returns and initializes the color of different chart elements.

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 colors in a Chart control
CHART_Chart1.Color(grColorLegend, LightRed)
CHART_Chart1.Draw() // Border of the legend drawn in red
CHART_Chart1.Color(grColorLegend, LightBlue) // The border is still red
CHART_Chart1.Draw() // The border of the legend drawn in blue

Syntax

Finding out the color of an element in a Chart control Hide the details

<Result> = <Chart control>.Color(<Element>)

<Result>: Integer

Color of the specified element in RGB format.
Caution: The value returned may differ according to the display configuration (resolution, ...).

<Chart control>: Control name

Name of the Chart control to use (found in the window editor, page editor or report editor).
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:
grColorAxis Color of axes.
grColorAxisSide Color of raised part of axes.
This constant is not available.
grColorBorder Color 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.
grColorBullishCandlestick Color of bars in a candlestick when the closing value is greater than the opening value.
This constant is not available.
grColorLegend Color of legend border.
grColorLegendBackground Legend background color.
grColorGridlines Gridline color.
grColorGridlinesSide Color of raised part of gridlines.
This constant is not available.

Modifying the color of an element in a Chart control Hide the details

<Chart control>.Color(<Element> [, <New color>])

<Chart control>: Control name

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

<Element>: Integer constant

Chart element whose color must be modified. This element can correspond to one of the following constants:
grColorAxis Color of axes.
grColorAxisSide Color of raised part of axes.
This constant is not available.
grColorBorder Color 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.
grColorBullishCandlestick Color of bars in a candlestick when the closing value is greater than the opening value.
This constant is not available.
grColorLegend Color of legend border.
grColorLegendBackground Legend background color.
grColorGridlines Gridline color.
grColorGridlinesSide Color of raised part of gridlines.
This constant is not available.

<New color>: Integer or constant (optional)

Color of specified element. This color corresponds to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color (see the preset colors of WLanguage).

Remarks

How to retrieve the components of the color?

To retrieve the components of the color returned by <Chart>.Color:

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 setting performed by <Chart>.Color will be taken into account during the next call to <Chart>.Draw or during the next drawing of the chart (when resizing the host control, when modifying the popup menu, ...).
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.
<Chart>.SeriesColor is used to modify the color of a series.
Versions 19 and later
<Chart>.CategoryColor is used to modify the color of categories for the Pie and Color charts.
New in version 19
<Chart>.CategoryColor is used to modify the color of categories for the Pie and Color charts.
<Chart>.CategoryColor is used to modify the color of categories for the Pie and Color charts.
<Chart>.ScatterSeriesColor is used to initialize the color of a series in a "Scatter" chart.
Versions 20 and later
<Chart>.SunburstSectionColor is used to change the color of a section in a Sunburst chart.
New in version 20
<Chart>.SunburstSectionColor is used to change the color of a section in a Sunburst chart.
<Chart>.SunburstSectionColor is used to change the color of a section in a Sunburst chart.
Versions 18 and later
<Chart>.SurfaceAltitudeColor is used to define the color used for the altitude (Z axis) in a Surface chart.
New in version 18
<Chart>.SurfaceAltitudeColor is used to define the color used for the altitude (Z axis) in a Surface chart.
<Chart>.SurfaceAltitudeColor is used to define the color used for the altitude (Z axis) in a Surface chart.
Versions 19 and later
<Chart>.WaterfallColor indicates the color for a type of category in a Waterfall chart.
New in version 19
<Chart>.WaterfallColor indicates the color for a type of category in a Waterfall chart.
<Chart>.WaterfallColor indicates the color for a type of category in a Waterfall chart.
Versions 21 and later
<Chart>.HMColor is used to define the color of values in a Heatmap chart.
New in version 21
<Chart>.HMColor is used to define the color of values in a Heatmap chart.
<Chart>.HMColor is used to define the color of values in a Heatmap chart.

Component : wd240grf.dll