Show / Hide Table of Contents

Property ReferenceScale

ReferenceScale

Gets or sets the reference scale for the map.

Declaration
public double ReferenceScale { get; set; }
Property Value
Type Description
Double

The reference scale. May be 0 when layer is not loaded, or if layer has no reference scale set.

Remarks

The reference scale of the map is the scale at which a client should view the map for the feature symbols and text to appear at their authored size.

If the client changes the viewing scale, then feature symbols and text will grow or shrink to keep a consistent size on the map (not the screen). This only happens if the reference scale is greater than zero and for feature layers that have ScaleSymbols set to true, otherwise the symbols and text stay at their authored size.

The reference scale will be zero if the map is not loaded or if there is no reference scale and the symbols and text should appear at default size regardless of the viewing scale.

This property is intended to be used for new map objects, that will have layers attached that expect a reference scale.

Subsequent updates to this property will cause a redraw of all layers that use the reference scale, and possible redraw of other layers that depend on them (e.g. dynamic labels that need to re-position to avoid overlaps).

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.5 - 200.0
.NET 6.0100.13 - 200.0
.NET 6.0 Windows100.13 - 200.0
.NET 6.0 Android200
.NET 6.0 iOS200
.NET Framework100.5 - 200.0
.NET 5100.10 - 100.12
.NET Core 3.1100.7 - 100.12
Android100.5 - 100.15
iOS100.5 - 100.15
UWP100.5 - 200.0
Relevant samples
Map reference scale: Set the map's reference scale and which feature layers should honor the reference scale.
In This Article
Back to top Copyright © 2022 Esri.