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


IMap.UseSymbolLevels Property (ArcObjects .NET 10.5 SDK)
ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IM > IMap Interface > IMap.UseSymbolLevels Property (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Carto)  

IMap.UseSymbolLevels Property

Indicates if the Map draws using symbol levels.

[Visual Basic .NET]
Public Property UseSymbolLevels As Boolean

[C#]
public bool UseSymbolLevels {get; set;}

[C++]
HRESULT get_UseSymbolLevels(
  VARIANT_BOOL* flag
);

[C++]
HRESULT put_UseSymbolLevels(
  VARIANT_BOOL flag
);

[C++]

Parameters
flag [out, retval]
  flag is a parameter of type VARIANT_BOOL
flag [in]
  flag is a parameter of type VARIANT_BOOL

Product Availability

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

Description

Determines whether Symbol Level Drawing is enabled for a Map.

Remarks

Symbol Level Drawing is useful when creating large scale maps with intersecting and overlapping line features. For example, on a large scale reference map with intersecting highways and streets, Symbol Level Drawing helps you create high-quality representations of the street and highway street intersections.

To set up Symbol Level Drawing:

  1. Turn on Symbol Level Drawing using either for your layer using ISymbolLevels::UseSymbolLevels, or for your entire map using IMap::UseSymbolLevels.
  2. For each layer that you want to set up symbol levels for, access that layer's renderer using IGeoFeatureLayer::Renderer.
  3. Access your layer's symbol(s) through the renderer.
  4. Using IMapLevel, set symbol levels on your layer's symbols. Symbols with MapLevel=0 draw first, then symbols with MapLevel=1, continuing until the highest MapLevel is reached. If two symbols have the same MapLevel, then the features drawn with these symbols are drawn in the normal layer order. A MapLevel of -1 for a multilayer symbol (MultiLayerMarkerSymbol, MultiLayerLineSymbol, MultiLayerFillSymbol) indicates that each of the symbol's individual layers are drawn with their individual MapLevel .

See Also

IMap Interface