This document is archived and information here might be outdated.  Recommended version.


IScaleDependentRenderer Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Carto)  

IScaleDependentRenderer Interface

Provides access to members that control a renderer which is composed of mulitple renderers, of which only one is enabled within a particular scale range.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

This interface provides access to a renderer that contains other feature renderers, and it allows you to specify different renderers for different scale ranges. For example, when a user views a layer at its full extent, features can be drawn with one symbology, and when the user zooms in far enough, the symbology can change to another. You can specify as many renderers and scale ranges as you need.

Members

Description
Method AddRenderer Adds a renderer to the end of the list.
Read/write property Break Scale value at which to break for the specified index.
Method MoveRenderer Moves renderer to the specified location in the list.
Method RemoveRenderer Removes the specified renderer from the list.
Read/write property Renderer The renderer at the specified index.
Read/write property RendererCount Number of renderers.

CoClasses that implement IScaleDependentRenderer

CoClasses and Classes Description
ScaleDependentRenderer A scale dependent renderer that is composed of multiple renderers, each operating within a particular scale range.

Remarks

For example, you could use this interface to set up a ScaleDependentRenderer when symbolizing a road network. Specify two different sub renderers and scale ranges. When zoomed out to the full extent, all of the roads could be drawn with the same line symbol -- using a SimpleRenderer. When zoomed in, the roads could be drawn based on road class by using a UniqueValueRenderer. With this renderer type, more important roads can be drawn with thicker, cased-line symbols.

The ScaleDependentRenderer is not available using the ArcGIS interface. To use this renderer you must use code to build and assign the renderer to a layer.

You can create scale dependent symbology using multiple layers, instead of multiple renderer assigned to a single layer through a ScaleDependentRenderer. For example, you can set up multiple feature layers and specify valid min and max display scales for each using IFeatureLayer::MinimumScale and IFeatureLayer::MaximumScale. This functionality is available using out-of-the box ArcGIS. To learn more, see the ArcGIS for Desktop Help.