IScaleText Interface

Provides access to members that control the scale text. Note: the IScaleText interface has been superseded by IScaleText2. Please consider using the more recent version.

Product Availability

Members

	Name	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.

Inherited Interfaces

Classes that implement IScaleText

Remarks

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.