ArcObjects Library Reference (Carto)  

ILayerDescription3 Interface

Provides access to the available properties of a layer description object.

Product Availability

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

Description

This interface is new at ArcGIS 9.3. It supersedes ILayerDescription and ILayerDescription2.

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 LayerResultOptions Indicate whether to include and/or modify Geometry.
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 SelectionBufferSymbol Symbol used for drawing selection buffer.
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 SourceID The id of the source to use when drawing the layer.
Read/write property Visible Indicates whether the layer is visible as defined in the TOC (i.e. marked on).

Inherited Interfaces

Interfaces Description
ILayerDescription2 Provides access to the available properties of a layer description object.
ILayerDescription Provides access to the available properties of a layer description object.

CoClasses that implement ILayerDescription3

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.

Use LayerResultOptions when you want to customize a query result.

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.