ArcObjects Library Reference (Controls)  

IMapControl3.MapScale Property

Scale of the map as a representative fraction.

[Visual Basic .NET]
Public Property MapScale As Double
[C#]
public double MapScale {get; set;}
[C++]
HRESULT get_MapScale(
  double* MapScale
);
[C++]
HRESULT put_MapScale(
  double MapScale
);
[C++]

Parameters

MapScale [out, retval]   MapScale is a parameter of type double MapScale [in]   MapScale is a parameter of type double

Product Availability

Available with ArcGIS Engine.

Description

This property is a shortcut to IMap::MapScale which itself is a shortcut to IDisplayTransformation::ScaleRatio.

Errors Returned

1000 800a03e8: An internal call to create an object has failed
1017 800a03f9: The current tracking or panning must complete before this method can execute
1022 800a03fe: The control requires a valid window to perform this method

Remarks

MapScale is the relationship between the dimensions of features on a map and the geographic objects they represent on the earth, commonly expressed as a fraction or a ratio.  A MapScale of 1/100,000 or 1:100,000 means that one unit of measure on the map equals 100,000 of the same units on the earth. Some common scales are as follows:

See Also

IMapControl3 Interface | IMapControl3.Map Property | IMapControl2.Map Property | IMapControl4.Map Property | IMapControl4.MapUnits Property | IMapControl3.MapUnits Property | IMapControl2.MapUnits Property | IMapControl4.ReferenceScale Property | IMapControl3.ReferenceScale Property | IMapControl2.ReferenceScale Property | IMapControl2.SpatialReference Property | IMapControl3.SpatialReference Property | IMapControl4.SpatialReference Property