com.ibm.as400.util.html
Class ButtonFormInput

java.lang.Object
  |
  +--com.ibm.as400.util.html.HTMLTagAttributes
        |
        +--com.ibm.as400.util.html.FormInput
              |
              +--com.ibm.as400.util.html.ButtonFormInput
All Implemented Interfaces:
HTMLTagElement, java.io.Serializable

public class ButtonFormInput
extends FormInput

The ButtonFormInput class represents a button input type in an HTML form. The trailing slash "/" on the ButtonFormInput tag allows it to conform to the XHTML specification.

Here is an example of a ButtonFormInput tag calling a javascript defined within a HTML page:
<input type="button" name="button1" value="Press Me" onclick="test()" />

Here is a sample javascript which displays an alert box with the specified message:

  <head>
  <script language="javascript">
     function test()
     {
        alert("This is a sample script executed with a ButtonFormInput.")
     }
  </script>
  </head>
  

ButtonFormInput objects generate the following events:

See Also:
Serialized Form

Constructor Summary
ButtonFormInput()
          Constructs a default ButtonFormInput object.
ButtonFormInput(java.lang.String name)
          Constructs a ButtonFormInput object with the specified control name.
ButtonFormInput(java.lang.String name, java.lang.String value)
          Constructs a ButtonFormInput object with the specified control name and viewable text value of the button.
ButtonFormInput(java.lang.String name, java.lang.String value, java.lang.String action)
          Constructs a ButtonFormInput object with the specified control name, viewable text value of the button, and the action to perform when the button is pressed.
 
Method Summary
 java.lang.String getAction()
          Returns the action being performed by the button.
 java.lang.String getTag()
          Returns the tag for the button form input type.
 void setAction(java.lang.String action)
          Sets the action to perform when the button is clicked.
 
Methods inherited from class com.ibm.as400.util.html.FormInput
addVetoableChangeListener, getDirection, getLanguage, getName, getSize, getValue, removeVetoableChangeListener, setDirection, setLanguage, setName, setSize, setValue, toString
 
Methods inherited from class com.ibm.as400.util.html.HTMLTagAttributes
addPropertyChangeListener, getAttributes, getAttributeString, removePropertyChangeListener, setAttributes
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ButtonFormInput

public ButtonFormInput()
Constructs a default ButtonFormInput object.

ButtonFormInput

public ButtonFormInput(java.lang.String name)
Constructs a ButtonFormInput object with the specified control name.
Parameters:
name - The control name of the input field.

ButtonFormInput

public ButtonFormInput(java.lang.String name,
                       java.lang.String value)
Constructs a ButtonFormInput object with the specified control name and viewable text value of the button.
Parameters:
name - The control name of the input field.
value - The viewable text value of the button.

ButtonFormInput

public ButtonFormInput(java.lang.String name,
                       java.lang.String value,
                       java.lang.String action)
Constructs a ButtonFormInput object with the specified control name, viewable text value of the button, and the action to perform when the button is pressed.
Parameters:
name - The control name of the input field.
value - The viewable text value of the button.
action - The script to execute.
Method Detail

getAction

public java.lang.String getAction()
Returns the action being performed by the button.
Returns:
The script being executed.

getTag

public java.lang.String getTag()
Returns the tag for the button form input type.
Returns:
The tag.

setAction

public void setAction(java.lang.String action)
               throws java.beans.PropertyVetoException
Sets the action to perform when the button is clicked. Buttons have no default behavior. Each button may have client-side scripts associated with the element's event attributes. When an event occurs (the user presses the button), the associated script is triggered.
Parameters:
action - The script to execute.
Throws:
java.beans.PropertyVetoException - If a change is vetoed.