Packageflexlib.controls
Classpublic class ImageMap
InheritanceImageMap Inheritance mx.controls.Image

The ImageMap control is an implementation of a client-side image map component, like it is supported in HTML.

ImageMap is an extension of the Image class, so you can specify the source attribute just like you would for a standard Image component. The map property is used to define the actual image map and all the area items that make up the map. The map property can be defined either in MXML or by setting it with Actionscript.

The intent is for you to be able to generate your image map in whatever program you use to create image maps, and be able to cut and paste it into your MXML component with minimal changes.

Example MXML usage:

  <ImageMap xmlns="flexlib.controls.
    source="usa.jpg"  
    showToolTips="true" 
    shapeClick="navigateToURL(new URLRequest(event.href), event.linkTarget)" 
    >
    
    <map>
     <area alt="WA" shape="POLY" coords="85,11,133,11,134,42,114,42,100,47,96,45,91,48,83,40,76,40,75,29,70,23,71,18,82,20,87,18" href="http://en.wikipedia.org/wiki/Washington" target="_blank"/>
     <area alt="OR" shape="POLY" coords="76,40,83,40,90,48,96,45,101,47,115,43,134,43,138,46,133,57,134,84,72,84,71,71,76,56" href="http://en.wikipedia.org/wiki/Oregon" target="_blank"/>   
    </map>
  
  </ImageMap>
  

See also

http://www.w3.org/TR/html4/struct/objects.html#client-side-maps


Public Properties
 PropertyDefined by
  map : Array
The <map /> HTML block that is normally used for the image map in an HTML file.
ImageMap
  showToolTips : Boolean = false
Indicates whether tool tips should be shown for each area.
ImageMap
  toolTipField : String = "alt"
Field of the <area /> item that will be used for the tooltip.
ImageMap
Protected Methods
 MethodDefined by
  
ImageMap
  
updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void
ImageMap
Events
 EventSummaryDefined by
   Fired when an area is clicked.ImageMap
   Fired when an area is double clicked.ImageMap
   Fired when the mouse is pressed down on an area.ImageMap
   Fired when the mouse moves out of an area.ImageMap
   Fired when the mouse moves over an area.ImageMap
   Fired when the mouse is released on an area.ImageMap
Styles
 StyleDescriptionDefined by
  
fillAlpha
Type: Number   Format: Length   CSS Inheritance: no
Alpha transparency of the fill of each area. Default is 0 so the areas are invisible. The default value is 0.
ImageMap
  
fillColor
Type: uint   Format: Color   CSS Inheritance: no
Fill color of each area. The default value is 0xff0000.
ImageMap
  
outlineAlpha
Type: Number   Format: Length   CSS Inheritance: no
Alpha transparency of the outline of each area. Default is 0 so the outlines are invisible. The default value is 0.
ImageMap
  
outlineColor
Type: uint   Format: Color   CSS Inheritance: no
Color of the outline of each area. The default value is 0xff0000.
ImageMap
  
outlineThickness
Type: Number   Format: Length   CSS Inheritance: no
Thickness of the outline of each area. The default value is 1.
ImageMap
Property detail
mapproperty
map:Array  [read-write]

The <map /> HTML block that is normally used for the image map in an HTML file. This should be wrapped as an XMLList and can either be cuopy/pasted straight into the MXML file, or set via Actionscript.

Implementation
    public function get map():Array
    public function set map(value:Array):void
showToolTipsproperty 
public var showToolTips:Boolean = false

Indicates whether tool tips should be shown for each area.

The default value is false.

toolTipFieldproperty 
public var toolTipField:String = "alt"

Field of the <area /> item that will be used for the tooltip.

The default value is "alt".

Method detail
createChildren()method
protected override function createChildren():void
updateDisplayList()method 
protected override function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):voidParameters
unscaledWidth:Number
 
unscaledHeight:Number
Event detail
shapeClickevent 
Event object type: flexlib.events.ImageMapEvent

Fired when an area is clicked.

shapeDoubleClickevent  
Event object type: flexlib.events.ImageMapEvent

Fired when an area is double clicked.

shapeDownevent  
Event object type: flexlib.events.ImageMapEvent

Fired when the mouse is pressed down on an area.

shapeOutevent  
Event object type: flexlib.events.ImageMapEvent

Fired when the mouse moves out of an area.

shapeOverevent  
Event object type: flexlib.events.ImageMapEvent

Fired when the mouse moves over an area.

shapeUpevent  
Event object type: flexlib.events.ImageMapEvent

Fired when the mouse is released on an area.