Table of Contents Previous Section


WOActiveImage

Synopsis

WOActiveImage { src=aPath | value=aMethod; action=aMethod | href=aURL; [imageMapFile=aString;] [name=aString;] [x=aNumber; y=aNumber;] [target=frameName;] [disabled=YES|NO;] ... };

Description

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.

src
Path to the file containing the image data. src can be statically specified in the declarations file, an object that responds to a description message by returning an NSString, or a method that returns an NSString.

value
Image data in the form of a WOElement object. This data can come from a database, a file, or memory.

action
Method to invoke when this element is clicked. If imageMapFile is specified, action is only invoked if the click is outside any mapped area. In other words, action defines the default action of the active image.

href
URL to direct the browser to as a default when the image is clicked and no hot zones are hit.

imageMapFile
Name of the image map file.

name
If name is specified then the hit point is specified as name.x=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.

x, y
If specified, returns the coordinates of the user's click within the image.

target
Frame in a frameset that will receive the page returned as a result of the user's click.

disabled
If YES, a regular image element (<IMG>) is generated rather than an active image.

The Image Map File

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
shape
Either `rect' or `circle' (polygon not yet supported). For `rect' shape, the coordinates x1,y1 specify the upper-left corner of the hot zone, and x2,y2 specify lower right corner. For `circle' shape, the x1,y1 is the origin, and x2,y2 is a point on the circle.

action
Name of the method to invoke.

coordinate-list
x1, y1 x2, y2 ...

Here's an example of an image map file:

  rect  home  0,0 135,56
  rect  buy  135,0 270,56

Examples

Image-mapped active image

Table of Contents Next Section