SetEqualRange

Declaration: ChartBook.Charts[].SetEqualRange (Layers: TIntArray);
The method SetEqualRange sets the extents of all layers specified by the parameter Layers in a way that all layers use the same scale. The new common scale is derived from the minimum and maximum ranges of the individual scales.

Hint: Please note the subtle difference between SetEqualRange and AutoRange. While AutoRange actually adjusts the scales to cover the entire data range, SetEqualRange compares only the current scale settings to find the maximum common range of all scales of the specified layers.

Example: This method is primarily used to ensure comparable scales for a set of layers. Let us assume that we have three layers, 2, 3, and 6, with the following ranges of their respective axes:
  Layer 2: x-axis ..... -3 to +20
           y-axis ..... 0 to +100
  Layer 3: x-axis ..... 0 to +1
           y-axis ..... -20 to -1
  Layer 6: x-axis ..... -5 to +10
           y-axis ..... +10 to +20
Executing the statement SetEqualRange ([2,3,6]); changes the ranges of these three layers as follows:
  all three x-axis: .... -5 to +20
  all three y-axis: .... -20 to +100
Thus all the data is now displayed using the common, comparable scale.