ChartDirector 7.1 (C++ Edition)
Layer.xZoneColor
Usage
int xZoneColor(double threshold, int belowColor, int aboveColor);
Description
Creates an x-zone color. An x-zone color will change from one color to another depending on a threshold value on the x-axis.
For example, if an x-zone color is used as the line color in a line layer, the line will switch from one color to another when its passes through a certain value on the x-axis. Similarly, if an x-zone color is used as the fill color in an area layer, the area will switch from one color to another when it passes through a certain value on the x-axis.
The two colors used in an x-zone color can be other dynamic colors. For example, one color can be a solid color, while the other color can be a dash line color (see !BaseChart.dashLineColor). When this x-zone color is as the line color, the line will change from a solid style to a dash line style when the line passes through a certain value on the x-axis
You may create x-zone colors with more than 2 zones by cascading multiple x-zone colors.
Arguments
Argument | Default | Description |
threshold | (Mandatory) | The x value serving as the threshold for switching between two colors. |
belowColor | (Mandatory) | The color to use when the x-axis value of the pixel is smaller than the threshold. |
aboveColor | (Mandatory) | The color to use when the x-axis value of the pixel is greater than the threshold. |
Return Value
A 32-bit integer representing the x-zone color.
© 2023 Advanced Software Engineering Limited. All rights reserved.