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.v25.2.Core.dll

NuGet Package : DevExpress.Gauges.Core

csharp

[DefaultValue(false)]
public bool AutoRescaling { get; set; }

<DefaultValue(False)>
Public Property AutoRescaling As Boolean

Property Value

Type	Default	Description
Boolean	false

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:

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.