ArcObjects Library Reference (Carto)  

ILegendInfo Interface

Provides access to members that control legend information provided by a renderer.

Product Availability

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

Description

Implemented by layers and renderers to manage legend information. Layers typically delegate the implementation of this interface to the renderer. Legend information appears in the ArcMap table of contents as well as in ArcMap legends.

Members

Description
Read-only property LegendGroup Legend group at the specified index.
Read-only property LegendGroupCount Number of legend groups contained by the object.
Read-only property LegendItem Optional. Defines legend formatting for layer rendered with this object.
Read/write property SymbolsAreGraduated Indicates if symbols are graduated.

CoClasses that implement ILegendInfo

CoClasses and Classes Description
BasemapSubLayer Wrapper for layers in the basemap.
BiUniqueValueRenderer A bivariate renderer that combines a unique values renderer with a class breaks renderer (either graduated colors or graduated symbol type symbology).
CadastralFabricSubLayer Cadastral Fabric Feature Layer Object.
CadFeatureLayer ESRI CAD Feature Layer class.
ChartRenderer A chart renderer used to draw pie, bar, and stacked bar chart symbols.
ClassBreaksRenderer A renderer that can be used to draw graduated color (choropleth) and graduated symbol maps.
CoTrackSymbologyRenderer (esriTrackingAnalyst) Symbolizes temporal based features and tracks in order to identify temporal feature characteristics in relation to the temporal reference.
DotDensityRenderer A dot density renderer.
DummyGraduatedMarkerLayer A dummy layer used to display legend items in the style gallery (Singleton).
DummyLayer A dummy layer used to display legend items in the style gallery (Singleton).
EnhancedInfoRenderer (esriTrackingAnalyst) Symbolizes temporal based features with attribute and spatial information; this renderer is in addition to using the standard event and track renderers.
FeatureLayer A collection of features and their visual representation.
GdbRasterCatalogLayer Geodabase RasterCatalog source and display options.
GeoSymRenderer (esriDefenseSolutions) Custom renderer for symbolizing data with GeoSym symbology.
GlobeServerLayer (esriGlobeCore) Provides programmatic access to a globe server layer.
ImageServerLayer Image server layer source and display options.
JoinedControlPointLayer (esriCadastralUI) Layer object that represents Control Points.
JoinedLinePointLayer (esriCadastralUI) Layer object that represents Joined LinePoints.
JoinedParcelLayer (esriCadastralUI) Layer object that represents Joined Parcels.
JoinedParcelLineLayer (esriCadastralUI) Layer object that represents Joined Parcel Lines.
JoinedPointLayer (esriCadastralUI) Layer object that represents Joined Points.
MADtedLayer (esriDefenseSolutions) A layer used to control the display of MA DTED Catalogs.
MapServerBasicSublayer Provides programmatic access to a basic map server sublayer.
MapServerFindSublayer Provides programmatic access to a map server sublayer with Find capability.
MapServerIdentifySublayer Provides programmatic access to a map server sublayer with Identify capability.
MapServerQuerySublayer Provides programmatic access to a map server sublayer with Find and Identify capability.
MARasterLayer (esriDefenseSolutions) A layer used to control the display of MA RPF Catalogs.
MoleEventRenderer (esriDefenseSolutions) Controls event rendering for the MOLE renderer.
NAStopRenderer (esriNetworkAnalyst) Defines symbology for rendering stops.
NetworkDirtyAreaRenderer A renderer used to display network dataset dirty areas.
NetworkLayer ESRI Network Layer CoClass.
NetworkTrafficRenderer A renderer used to display network dataset traffic.
PacketJoinedLayer (esriCadastralUI) Layer object that represents a packet of Joined Parcels, Lines, Points, Control Points, LinePoints and Text.
ProportionalSymbolRenderer A proportional symbol renderer, used to draw symbols of varying size for each feature, sized in proportion to a field value.
RasterCatalogLayer Raster catalog source and display options.
RasterClassifyColorRampRenderer A renderer with a color ramp for rasters with classified values.
RasterColormapRenderer A raster colormap renderer.
RasterDiscreteColorRenderer A raster discrete color renderer.
RasterLayer Raster layer source and display options.
RasterRGBRenderer A true-color RGB renderer.
RasterStretchColorRampRenderer A renderer with a color ramp for rasters with continuous values.
RasterUniqueValueRenderer A renderer for rasters with unique values.
RepresentationRenderer A renderer that draws features using representation information stored in the layers data source.
ScaleDependentRenderer A scale dependent renderer that is composed of multiple renderers, each operating within a particular scale range.
SimpleNetworkRenderer A simple renderer used to display network dataset junctions, edges, and turns.
SimpleRenderer A simple renderer where the same symbol is drawn for each feature.
TemporalFeatureLayer (esriTrackingAnalyst) Defines the coclass IDL parameters and attributes of the TemporalFeatureLayer COM object.
TerrainDirtyAreaRenderer Terrain dirty area renderer component.
TerrainLayer The Terrain Layer class.
TerrainPointAttributeRenderer Terrain point renderer component.
TerrainPointElevationRenderer Terrain point renderer component.
TerrainPointUniqueValueRenderer Terrain point unique value renderer component.
TinAspectRenderer TIN aspect renderer component.
TinBreaklineRenderer TIN breakline renderer component.
TinContourRenderer TIN contour renderer component.
TinEdgeRenderer TIN edge renderer component.
TinElevationRenderer TIN elevation renderer component.
TinFaceRenderer TIN face renderer component.
TinFaceValueRenderer TIN face value renderer component.
TinLayer The TIN Layer class.
TinNodeElevationRenderer TIN node elevation renderer component.
TinNodeRenderer TIN node renderer component.
TinNodeValueRenderer TIN node value renderer component.
TinSlopeRenderer TIN slope renderer component.
TopologyLayer A collection of properties for a topology layer.
UniqueValueRenderer A unique values renderer where symbols are assigned to features based on an unique attribute values.
UniqueValueTextRenderer (esriTrackingAnalyst) This is a feature renderer that supports rendering points using values from a field in the feature class.
WCSLayer WCS layer source and display options.

Remarks

This interface provides access to a layer or renderer's legend information and symbols. Use this interface to access the information about a layer or renderer that appears in the table of contents and also in legends.

All ESRI renderers have at least one LegendGroup which in turn has at least one LegendClass. Though renderers typically store all of the symbols they use to draw features in their LegendClass objects, it is best to access these symbols via the specific renderer interface for the renderer object you are using. For example, when rendering features, for a ClassBreaksRenderer use IClassBreaksRenderer::Symbol, or for a ProportionalSymbolRenderer use IProportionalSymbolRenderer::MinSymbol and IProportionalSymbolRenderer::BackgroundSymbol.

Some renderers, for example SimpleRenderer, ClassBreaksRenderer, and UniqueValueRenderer, update the legend groups and legend classes automatically when you set the renderer symbols. However, other renderers require you to call a method on a renderer specific interface to update the legend after making a symbol change. For the ProportionalSymbolRenderer, ChartRenderer, DotDensityRenderer, and BiUniqueValueRenderer you must do this. For example, call IProportionalSymbolRenderer:CreateLegendSymbols to update the legend for a layer symbolized with a ProportionalSymbolRenderer.