Table of Contents
Previous Section
aPath
| value=aMethod
; action=aMethod
| href=aURL
; [imageMapFile=aString
;] [name=aString
;] [x=aNumber
; y=aNumber
;] [target=frameName
;] [disabled=YES|NO;] ... };A WOActiveImage displays an image within the HTML page. If the WOActiveImage is disabled, it simply displays its image as a passive element in the page. If enabled, the image is active, that is, clicking the image generates a request.
If located outside an HTML form, a WOActiveImage functions as a mapped, active image. When the user clicks such a WOActiveImage, the coordinates of the click are sent back to the server. Depending on where the user clicks, different actions can be invoked. An image map file associates actions with each of the defined areas of the image.
Within an HTML form, a WOActiveImage functions as a graphical submit button. You typically use WOActiveImages when you need more than one submit button within a form.
value
; name.y=value
; in the form. This is useful when you need to use this element to submit a form to an external URL that expects the hit point to be expressed in a certain format.If imageMapFile is specified, WebObjects searches for the file within the component bundle (Component
.wo/). If it isn't found there, WebObjects searches the application directory (MyApplication
.woa/).
Each line in the image map file has this format:
shape action coordinate-list
Here's an example of an image map file:
rect home 0,0 135,56
rect buy 135,0 270,56