Skip to main content

ArcScale.AutoRescaling Property

Gets or sets whether the scale’s range of values is automatically expanded when the scale’s current Value reaches either the ArcScale.MinValue or ArcScale.MaxValue.

Namespace: DevExpress.XtraGauges.Core.Model

Assembly: DevExpress.XtraGauges.v24.1.Core.dll

NuGet Package: DevExpress.Gauges.Core

Declaration

[XtraSerializableProperty]
public bool AutoRescaling { get; set; }

Property Value

Type Description
Boolean

true if the auto-expanding of the scale’s minimum and maximum values is enabled; otherwise, false.

Remarks

If the AutoRescaling property is set to false, values of the ArcScale.MinValue and ArcScale.MaxValue properties are fixed, and they are not dependant on the scale’s current ArcScale.Value.

Setting the AutoRescaling property to true enables the auto-adjustment of the scale’s bounds depending on the current value.

The scale’s ArcScale.MinValue is automatically reduced when the scale’s current Value falls into the range [MinValue; MinValue+ThresholdMin]. Similarly, the scale’s ArcScale.MaxValue is automatically increased when the scale’s current Value falls into the range [MaxValue-ThresholdMax; MaxValue]. So, the scale’s bounds are automatically expanded when the scale’s Value reaches one of the bounds.

The ThresholdMin and ThresholdMax are marked for a circular gauge in the image below:

ArcScaleAutoRescaling_Thresholds

The actual values of the ThresholdMin and ThresholdMax are calculated according to the ArcScale.RescalingThresholdMin and ArcScale.RescalingThresholdMax properties, which specify these thresholds in percents.

The ArcScale.RescalingBestValues property, if set to true, enables the algorithm for smart ArcScale.MinValue and ArcScale.MaxValue calculations. This algorithm tries to set the ArcScale.MinValue and/or ArcScale.MaxValue to values that are multiples of 2, 3 or 5.

The ArcScale.CustomRescaling event allows you to implement a custom algorithm for the ArcScale.MinValue and ArcScale.MaxValue correction.

See Also