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


ScaleDependentRenderer CoClass (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Carto)  

ScaleDependentRenderer CoClass

A scale dependent renderer that is composed of multiple renderers, each operating within a particular scale range.

Product Availability

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

Description

This renderer contains other 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.

Supported Platforms

Windows, Solaris, Linux

Interfaces

Interfaces Description
IExportSupport Provides access to export support members.
IFeatureRenderer Provides access to members that control functionality common to all feature renderers.
ILegendInfo Provides access to members that control legend information provided by a renderer.
IPersist Defines the single method GetClassID, which is designed to supply the CLSID of an object that can be stored persistently in the system. IPersist is the base interface for three other interfaces: IPersistStorage, IPersistStream, and IPersistFile.
IPersistStream (esriSystem)
IScaleDependentRenderer 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.

Remarks

For example, you could use the 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.