com.esri.arcgis.carto
Interface IMapServerLayer

All Superinterfaces:
Serializable
All Known Implementing Classes:
MapServerLayer

public interface IMapServerLayer
extends Serializable

Provides access to the available properties of a map server layer object.

Product Availability

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


Method Summary
 void clearDrawCache()
          Clears the cache of images downloaded from the server redraw.
 IColor getBackgroundColor()
          The background color of a map server layer object.
 void getConnectionInfo(IAGSServerObjectName[] soName, String[] docLocation, String[] mapName)
          Returns information about a connection to a map server object or to a map document.
 IColor getTransparentColor()
          The color that is transparent (100 %).
 void localConnect(String docLocation, String mapName)
          Connects to map document data frame specified by the location of a map document and the name of a data frame.
 void serverConnect(IAGSServerObjectName soName, String mapName)
          Connects to map server object specified by the AGSServerObject name for a MapServer server object and the name of a data frame.
 void setTransparentColor(IColor color)
          The color that is transparent (100 %).
 

Method Detail

localConnect

void localConnect(String docLocation,
                  String mapName)
                  throws IOException,
                         AutomationException
Connects to map document data frame specified by the location of a map document and the name of a data frame.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
docLocation - The docLocation (in)
mapName - The mapName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

serverConnect

void serverConnect(IAGSServerObjectName soName,
                   String mapName)
                   throws IOException,
                          AutomationException
Connects to map server object specified by the AGSServerObject name for a MapServer server object and the name of a data frame.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
soName - A reference to a com.esri.arcgis.gisclient.IAGSServerObjectName (in)
mapName - The mapName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getConnectionInfo

void getConnectionInfo(IAGSServerObjectName[] soName,
                       String[] docLocation,
                       String[] mapName)
                       throws IOException,
                              AutomationException
Returns information about a connection to a map server object or to a map document.

Remarks

If the connection is to a MapServer object, the GetConnectionInfo method returns the AGSServerObjectName and the name of the data frame. If the connection is made to a map document (.mxd of .pmf), this method returns the location of the map document and the name of the data frame.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
soName - A reference to a com.esri.arcgis.gisclient.IAGSServerObjectName (out: use single element array)
docLocation - The docLocation (out: use single element array)
mapName - The mapName (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

clearDrawCache

void clearDrawCache()
                    throws IOException,
                           AutomationException
Clears the cache of images downloaded from the server redraw.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBackgroundColor

IColor getBackgroundColor()
                          throws IOException,
                                 AutomationException
The background color of a map server layer object.

Remarks

Use BackgroundColor to retrieve the color for the background of a map server layer object. The BackgroundColor of a map server layer is transparent by default when it is added to an application.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.display.IColor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getTransparentColor

IColor getTransparentColor()
                           throws IOException,
                                  AutomationException
The color that is transparent (100 %).

Remarks

Setting a transparent color is valid only for formats that support transparency. These include: png, png24 and gif. When adding a MapServerLayer to ArcMap the TransparentColor value is equal to the value of the BackgroundColor. Therefore, the background is transparent by default.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.display.IColor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setTransparentColor

void setTransparentColor(IColor color)
                         throws IOException,
                                AutomationException
The color that is transparent (100 %).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
color - A reference to a com.esri.arcgis.display.IColor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.