- How to retrieve the components of the color?
- Colors of chart elements (legends, ...)
- Colors in the charts (series, section, ...)
grColor (Function) In french: grCouleur Returns and initializes the color of different chart elements.
// 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.
<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.
| | 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.
| | grColorGridlines | Gridline color. | | grColorGridlinesSide | Color of raised part of gridlines.
| | grColorLegend | Color of legend border. | | grColorLegendBackground | Legend 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.
<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. | | 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. | | grColorGridlines | Gridline color. | | grColorGridlinesSide | Color of raised part of gridlines. | | grColorLegend | Color of legend border. | | grColorLegendBackground | Legend background color. |
<New color>: Integer or constant (optional) Color of 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.
This page is also available for…
|
|
|
|