Packagecom.esri.ags.layers
Classpublic class MapImageLayer
InheritanceMapImageLayer Inheritance Layer Inheritance mx.core.UIComponent

The MapImageLayer class is used to add georeferenced images to the map. The map will place the georeferenced images at the specified geographic extent. The extent of the image should be within the map's extent. The image should also be in the same coordinate system as the map.

Default MXML PropertymapImageProvider

See also

com.esri.ags.layers.supportClasses.MapImage


Public Properties
 PropertyDefined By
  initialExtent : Extent
[override] Initial extent of the layer.
MapImageLayer
 InheritedisInScaleRange : Boolean
[read-only] Returns true if the current scale of the map is between the maximum and minimum scale of the layer [added in version 1.3].
Layer
 Inheritedloaded : Boolean
[read-only] When the layer is loaded, the value becomes "true" and layer properties can be accessed.
Layer
 InheritedloadFault : Fault
[read-only] A reference to the fault that is dispatched when the layer throws a loadError event.
Layer
 Inheritedmap : Map
[read-only] A reference to the Map this layer is in.
Layer
  mapImageProvider : Object
Set of images to be viewed.
MapImageLayer
 InheritedmaxScale : Number
The maximum scale of the layer [added in version 1.3].
Layer
 InheritedminScale : Number
The minimum scale of the layer [added in version 1.3].
Layer
 InheritedspatialReference : SpatialReference
[read-only] The spatial reference of the layer.
Layer
 Inheritedunits : String
[read-only] The units of the layer.
Layer
Public Methods
 MethodDefined By
  
Creates a new MapImageLayer
MapImageLayer
  
add(mapImage:MapImage):void
Add an image to the map.
MapImageLayer
  
getImageVisibility(mapImage:MapImage):Boolean
Gets the current visibility of the input MapImage.
MapImageLayer
 Inherited
refresh():void
Causes the layer to redraw or reload its content.
Layer
  
remove(mapImage:MapImage):void
Remove the specified image from the layer.
MapImageLayer
  
removeAll():void
Remove all images from the layer.
MapImageLayer
  
setImageVisibility(mapImage:MapImage, isVisible:Boolean):void
Set the visibility for the image.
MapImageLayer
Protected Methods
 MethodDefined By
 Inherited
Adds listeners for ExtentEvent.EXTENT_CHANGE, ZoomEvent.ZOOM_START, ZoomEvent.ZOOM_UPDATE and ZoomEvent.ZOOM_END.
Layer
 Inherited
When an EXTENT_CHANGE event occurs, this calls invalidateLayer();
Layer
 Inherited
hideHandler(event:FlexEvent):void
When the layer is hidden (visible is set to false), this calls removeMapListeners().
Layer
 Inherited
Subclasses should call this whenever they would like to have updateLayer() called on them.
Layer
 Inherited
Removes all the layers children.
Layer
 Inherited
Removes the four event listeners added by addMapListeners();
Layer
 Inherited
setLoaded(value:Boolean):void
Subclasses must call this when they've loaded all their properties and are ready to load their content.
Layer
 Inherited
showHandler(event:FlexEvent):void
When the layer is shown (visible is set to true), this calls addMapListeners() and invalidateLayer().
Layer
 Inherited
toScreenX(mapX:Number):Number
Converts the x-coordinate of map point to a screen point.
Layer
 Inherited
toScreenY(mapY:Number):Number
Converts the y-coordinate of map point to a screen point.
Layer
 Inherited
Subclasses must override this method.
Layer
 Inherited
Finishes the zoom animation.
Layer
 Inherited
Prepares the zoom animation by taking a bitmap of the layer.
Layer
 Inherited
Redraws the bitmap of the layer.
Layer
Events
 Event Summary Defined By
 InheritedFires if the value of isInScaleRange changes.Layer
 InheritedFires after layer properties for the layer are successfully populated.Layer
 InheritedFires if the layer is unable to load.Layer
 InheritedFires when the layer has finished updating its content.Layer
 InheritedFires when the layer begins to update its content.Layer
Property Detail
initialExtentproperty
initialExtent:Extent[override]

Initial extent of the layer. Used by the map if it is the first layer in the map and map doesn't have an extent specified.

The default value is new Extent(-180, -90, 180, 90, new SpatialReference(4326)).


Implementation
    public function get initialExtent():Extent
    public function set initialExtent(value:Extent):void
mapImageProviderproperty 
mapImageProvider:Object

Set of images to be viewed. This property lets you use either an Array, an ArrayCollection. If you set the mapImageProvider property to an Array, it will be converted to an ArrayCollection. If you set the property to an ArrayCollection, it will be used directly. If you set the property to a single MapImage, it will be wrapped in a new ArrayCollection.

As a consequence of the conversions, when you get the mapImageProvider property, it will always be an ArrayCollection.

The default value is an empty ArrayCollection.

This property can be used as the source for data binding.


Implementation
    public function get mapImageProvider():Object
    public function set mapImageProvider(value:Object):void

See also

Constructor Detail
MapImageLayer()Constructor
public function MapImageLayer()

Creates a new MapImageLayer

Method Detail
add()method
public function add(mapImage:MapImage):void

Add an image to the map. The Map Image extent should have the same coordinate system as the map and be within the map's extent.

Parameters

mapImage:MapImage

getImageVisibility()method 
public function getImageVisibility(mapImage:MapImage):Boolean

Gets the current visibility of the input MapImage.

Parameters

mapImage:MapImage

Returns
Boolean
remove()method 
public function remove(mapImage:MapImage):void

Remove the specified image from the layer.

Parameters

mapImage:MapImage

removeAll()method 
public function removeAll():void

Remove all images from the layer.

setImageVisibility()method 
public function setImageVisibility(mapImage:MapImage, isVisible:Boolean):void

Set the visibility for the image.

Parameters

mapImage:MapImage
 
isVisible:Boolean