This document is archived and information here might be outdated. Recommended version. |
ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IS > IScaleText Interface (ArcObjects .NET 10.5 SDK) |
Provides access to members that control the scale text. Note: the IScaleText interface has been superseded byIScaleText2. Please consider using the more recent version.
Description | ||
---|---|---|
DelayEvents | Used to batch operations together to minimize notifications. | |
Draw | Draws the map surround into the specified display bounds. | |
FitToBounds | Adjusts the map surround to fit the bounds. The changed argument indicates whether the size of the map surround was changed. | |
Format | Format of the scale text. Style must be set to custom. | |
Icon | Icon used to represent the map surround. | |
Map | The parent map. | |
MapUnitLabel | Map unit label of the scale text. Style must be set to relative. | |
MapUnits | Map units of the scale text. Style must be set to custom. | |
Name | Name of the map surround. | |
NumberFormat | Number formatting. | |
PageUnitLabel | Page unit label of the scale text. Style must be set to relative. | |
PageUnits | Page units of the scale text. Style must be set to custom. | |
QueryBounds | Returns the bounds of the map surround. | |
Refresh | Makes sure the latest updates are refected the next time the Map Surround is drawn. | |
Style | Style of the scale text. | |
Symbol | Symbol of the scale text. | |
Text | The scale text. |
Interfaces | Description |
---|---|
IMapSurround | Provides access to members that control the map surround. |
CoClasses and Classes | Description |
---|---|
ScaleText | A map surround for displaying a scale text. |
ScaleText is essentially a text element that describes the map�s scale. One example of scale text is �1 inch equals 2,400 miles�.
The interface IScaleText controls the format of the string that is added as a map surround element.
Text returns the text displayed e.g. �1 inch equals 2,400 miles�.
Symbol is a text symbol that you may access to modify its appearance.
NumberFormat is an INumberFormat that allows you for instance to modify the number of decimals used to display the map units.
The MapUnits and PageUnits are esriUnits and will initially reflect the current map units and page layout units. They can be set to any units to suit your needs.
The MapUnitLabel and PageUnitLabel are the labels describing the units used in the scale text. For instance, "kilometers" which you may change to "km" by setting the MapUnitLabel property.
The Style property is an esriScaleTextStyleEnum and can take two values defining if the scale text type is relative - �1 inch equals 2,400 miles� - or absolute - "1:200,000". Relative scale text is the default.
The Format property is not currently implemented.
There is no way to change the text in any other way than those listed here except by converting the Scale Text to graphics after it has been created or reading the text it returns and create your own text element to display it but the resulting scale will not be linked to the scale of the map frame anymore.