com.esri.arcgis.carto
Interface IMapServerSublayer

All Superinterfaces:
Serializable
All Known Implementing Classes:
IMapServerSublayerProxy, MapServerBasicSublayer, MapServerFindSublayer, MapServerIdentifySublayer, MapServerQuerySublayer

public interface IMapServerSublayer
extends Serializable

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

Superseded By

IMapServerSublayer2

Product Availability

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

Supported Platforms

Windows, Solaris, Linux


Method Summary
 ILayerDescription getLayerDescription()
          The layer description.
 boolean isHasLabels()
          Indicates if the layer has labels to turn on and off.
 boolean isScaleSymbols()
          Indicates whether the layer should scale its symbols according to the reference scale.
 boolean isShowLabels()
          Indicates whether the layer should display its dynamic labels.
 void setScaleSymbols(boolean scaleSymbols)
          Indicates whether the layer should scale its symbols according to the reference scale.
 void setShowLabels(boolean show)
          Indicates whether the layer should display its dynamic labels.
 

Method Detail

isHasLabels

boolean isHasLabels()
                    throws IOException,
                           AutomationException
Indicates if the layer has labels to turn on and off.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

isShowLabels

boolean isShowLabels()
                     throws IOException,
                            AutomationException
Indicates whether the layer should display its dynamic labels.

Remarks

This only applies to layers where the property HasLabels on IMapServerSubLayer is TRUE. This means that the layer's labels must be "on" in the original map document.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setShowLabels

void setShowLabels(boolean show)
                   throws IOException,
                          AutomationException
Indicates whether the layer should display its dynamic labels.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

isScaleSymbols

boolean isScaleSymbols()
                       throws IOException,
                              AutomationException
Indicates whether the layer should scale its symbols according to the reference scale.

Remarks

A reference scale set for a map containing a Map Server object will have no effect on Map Server layer symbology. In order for symbols to scale, the originial map document on which the Map Server object is based must have a reference scale set. The Map layer must also support symbol scaling. If both these conditions are true, use ScaleSymbols to activate or deactivate a Map Server Sublayer's symbol scaling.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setScaleSymbols

void setScaleSymbols(boolean scaleSymbols)
                     throws IOException,
                            AutomationException
Indicates whether the layer should scale its symbols according to the reference scale.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getLayerDescription

ILayerDescription getLayerDescription()
                                      throws IOException,
                                             AutomationException
The layer description.

Remarks

Use LayerDescription to access properties of ILayerDescription. The ID value may not match the Layer index value on ICompositeLayer or ICompositeLayer2. This is because the count on ICompositeLayer or ICompositeLayer2 does not include members of composite layers embedded within the MapServerSublayer. Only the parent layer is counted.

MapServerSubLayer does not support the ILayerDescription properties ScaleSymbols, ShowLabels and Visible. ScaleSymbols and ShowLabels can be accessed via IMapServerSubLayer. The property controlling a MapServerSubLayers visibility, Visible, can be accessed via ILayer.

The ILayerDescription properties SelectionFeatures, SelectionColor, SelectionSymbol, SetSelectionSymbol, SelectionBufferDistance and ShowSelectionBuffer can be used to select and buffer (euclidean buffer) features of a Map Server SubLayer.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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