Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

RangeControl.VisibleRangeScaleFactor Property

Gets or sets the current scale (zoom) factor.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.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