ArcObjects Library Reference (Carto)  

IMapDescription2 Interface

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

Product Availability

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

When To Use

 Use the IMapDescription interface to access read and write properties of a map (data frame).

Members

Description
Read/write property BackgroundSymbol Background symbol of the Map.
Read/write property CustomGraphics Custom graphics.
Read/write property LayerDescriptions A collection of Layer Description objects, each describing a layer within the map (data frame).
Read/write property MapArea The display area of the map (data frame).
Read/write property MapRotation The angle/rotation of the map (data frame) in degrees, measured anti-clockwise.
Read/write property Name The name of the map (data frame).
Read/write property SelectionColor The default selection color.
Read/write property SpatialReference The spatial reference of the map (data frame).
Read/write property TransparentColor The color that is transparent (100 %).

CoClasses that implement IMapDescription2

CoClasses and Classes Description
MapDescription The Map Description coclass contains settings of a map in the current document.

Remarks

Use IMapDescription2 to access map settings that can be changed on the server object without changing the state of the underlying fine-grained ArcObjects that the map document is based on. Please note the difference between IMapServerInfo and IMapDescription. MapServerInfo is used to retrieve information about a map, such as the name of the map, the background color or the spatial extent for the map. These settings cannot be changed without direct access to the map document or the fine-grained ArcObjects it is based on.

Map 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.