Documentation Archive Developer
Search
Table of Contents Previous Section

WOImageButton

Synopsis

WOImageButton { filename=anImageName; [framework=aFrameworkName|"app";] | src=aURL; | value=aMethod; action=aMethod; [imageMapFile=aString]; [name=aString;] [x=aNumber; y=aNumber;] [disabled=YES|NO;] ... };

Description

WOImageButton is a graphical submit button. Clicking the image generates a request and submits the enclosing form's values. You often use WOImageButton when you need more than one submit button within a form.

filename
Path to the image relative to the WebServerResources directory.
framework
Framework that contains the image file. This attribute is only necessary if the image file is in a different location from the component. That is, if the component and the image file are both in the application or if the component and the image file are both in the same framework, this attribute isn't necessary. If the image file is in a framework and the component is in an application, specify the framework's name here (minus the .framework extension). If the image file should be in the application but the component is in a framework, specify the "app" keyword in place of the framework name.
src
URL containing the image data. Use this attribute for complete URLs; for relative URLs use filename instead.
value
Image data in the form of a WOElement object. This data can come from a database, a file, or memory.
action
Action method to invoke when this element is clicked.
imageMapFile
Name of the image map file. See the WOActiveImage description for more information.
name
Name that uniquely identifies this element within the form. You may specify a name or let WebObjects automatically assign one at runtime.
x, y
If specified, returns the coordinates of the user's click within the image.
disabled
If disabled evaluates to YES, the element generates a static image (<IMG>) instead of an active image.

Examples

An image as a button

Table of Contents Next Section