Skip to main content

RangeControl.VisibleRangeScaleFactor Property

Gets or sets the current scale (zoom) factor.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(1)]
[DXCategory("Behavior")]
public double VisibleRangeScaleFactor { get; set; }

Property Value

Type Default Description
Double 1

A double value, greater than or equal to 1, that specifies the current scale factor.

Remarks

A scale(zoom) factor is a value greater than or equal to 1. A scale factor of 1 means that data is not zoomed. A scale factor of 2 means that data is zoomed by 2X, etc.

An end-user can zoom data via the Zoom and Scroll Bar. The current scale(zoom) factor is specified by the VisibleRangeScaleFactor property. To prevent a user from zooming data beyond a specific zoom level, use the RangeControl.VisibleRangeMaximumScaleFactor property.

The VisibleRangeScaleFactor is used to calculate the width of the visible range (RangeControl.VisibleRangeWidth) relative to the total data range. These values are linked by the formula:

VisibleRangeWidth = 1/VisibleRangeScaleFactor.

See Also