ArcObjects Library Reference (Carto)  

ILayerDescription Interface

Provides access to the available properties of a layer description object. Note: the ILayerDescription interface has been superseded byILayerDescription3. Please consider using the more recent version.

Product Availability

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

When To Use

Use the ILayerDescription interface to access read and write properties of a layer.

Members

Description
Read/write property DefinitionExpression The definition expression for the layer.
Read/write property ID The layer ID. This is a unique ID for the layer, and is used to identify the layer in a number of method calls.
Read/write property ScaleSymbols Indicates whether the layer should scale its symbols according to the reference scale.
Read/write property SelectionBufferDistance The selection buffer distance. When drawing, and if a selection filter is specified, a buffer zone of the specified distance will be displayed around the selected features.
Read/write property SelectionColor The selection color (used when SetSelectionSymbol = FALSE).
Read/write property SelectionFeatures Array of selected features.
Read/write property SelectionSymbol The selection symbol.
Read/write property SetSelectionSymbol Indicates if the selected set of features is drawn using the SelectionSymbol.
Read/write property ShowLabels Indicates whether the layer should display its dynamic labels.
Read/write property ShowSelectionBuffer Indicates whether the selection buffer should be displayed.
Read/write property Visible Indicates whether the layer is visible as defined in the TOC (i.e. marked on).

CoClasses that implement ILayerDescription

CoClasses and Classes Description
LayerDescription The Layer Description coclass contains settings of a layer in a map.

Remarks

Please note the difference of use between IMapLayerInfo and ILayerDescription: Use ILayerDescription to access layer settings that can be changed on the server object without changing the state of the underlying fine-grained ArcObjects that the layer is based on. MapLayerInfo is used to retrieve information about a layer that can only be changed by directly accessing the map document or the fine-grained ArcObjects it is based on.

In some cases you may want limit or adjust the geometry being returned in the find result. This can be done for performance reasons. Use ILayerResultOptions to manage this. If IncludeGeometry is set to False, FeatureShape returns nothing. This should increase performance in cases where feature geometry is large. You can also choose to densify or generalize the geometry returned in FeatureShape using GeometryResultOptions. Densification is used to better support clients that do not support Arcs (e.g. Bezier, Circular etc.). Generalization reduces the amount of geography being sent across the network and should lead to better performance. If LayerResultOptions are not specified for the LayerDescription, query results will include the original geometry.

Layer settings of the Server object can be permanently changed by accessing fine-grained ArcObjects. This is accomplished using IMapServerObjects. This should be done with objects in a non-pooled environment.  Changing the state of pooled objects this way will lead to unexpected results. Changes made using IMapServerObjects reside in memory only. They affect only the instance of the map service being accessed. They do not change anything in the original map document (.mxd) saved on disk. These changes exist until the service is restarted or recycled.