javax.swing.text.html
Class FormView

java.lang.Object
  extended by javax.swing.text.View
      extended by javax.swing.text.ComponentView
          extended by javax.swing.text.html.FormView
All Implemented Interfaces:
ActionListener, EventListener, SwingConstants

public class FormView
extends ComponentView
implements ActionListener

A View that renders HTML form elements like buttons and input fields. This is implemented as a ComponentView that creates different Swing component depending on the type and setting of the different form elements. Namely, this view creates the following components:

Element typeSwing component
input, buttonJButton
input, checkboxJButton
input, imageJButton
input, passwordJButton
input, radioJButton
input, resetJButton
input, submitJButton
input, textJButton
select, size > 1 or with multiple attribute JList in JScrollPane
select, size unspecified or == 1JComboBox
textarea, textJTextArea in JScrollPane
input, fileJTextField


Nested Class Summary
protected  class FormView.MouseEventListener
           
 
Field Summary
static String RESET
          Deprecated. As of JDK1.3 the value is fetched from the UIManager property FormView.resetButtonText.
static String SUBMIT
          Deprecated. As of JDK1.3 the value is fetched from the UIManager property FormView.submitButtonText.
 
Fields inherited from class javax.swing.text.View
BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
 
Fields inherited from interface javax.swing.SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
 
Constructor Summary
FormView(Element el)
          Creates a new FormView.
 
Method Summary
 void actionPerformed(ActionEvent ev)
          Processes an action from the Swing component.
protected  Component createComponent()
          Creates the correct AWT component for rendering the form element.
 float getMaximumSpan(int axis)
          Determines the maximum span for this view on the specified axis.
protected  void imageSubmit(String imageData)
          Submits the form data in response to a click on a <input type="image"> element.
protected  void submitData(String data)
          Submits the form data.
 
Methods inherited from class javax.swing.text.ComponentView
getAlignment, getComponent, getMinimumSpan, getPreferredSpan, modelToView, paint, setParent, viewToModel
 
Methods inherited from class javax.swing.text.View
append, breakView, changedUpdate, createFragment, dump, forwardUpdate, forwardUpdateToView, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, setSize, updateChildren, updateLayout, viewToModel
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

SUBMIT

public static final String SUBMIT
Deprecated. As of JDK1.3 the value is fetched from the UIManager property FormView.submitButtonText.
If the value attribute of an <input type="submit">> tag is not specified, then this string is used.


RESET

public static final String RESET
Deprecated. As of JDK1.3 the value is fetched from the UIManager property FormView.resetButtonText.
If the value attribute of an <input type="reset">> tag is not specified, then this string is used.

Constructor Detail

FormView

public FormView(Element el)
Creates a new FormView.

Parameters:
el - the element that is displayed by this view.
Method Detail

createComponent

protected Component createComponent()
Creates the correct AWT component for rendering the form element.

Overrides:
createComponent in class ComponentView
Returns:
the component that is rendered

getMaximumSpan

public float getMaximumSpan(int axis)
Determines the maximum span for this view on the specified axis.

Overrides:
getMaximumSpan in class ComponentView
Parameters:
axis - the axis along which to determine the span
Returns:
the maximum span for this view on the specified axis
Throws:
IllegalArgumentException - if the axis is invalid

actionPerformed

public void actionPerformed(ActionEvent ev)
Processes an action from the Swing component. If the action comes from a submit button, the form is submitted by calling submitData(java.lang.String). In the case of a reset button, the form is reset to the original state. If the action comes from a password or text field, then the input focus is transferred to the next input element in the form, unless this text/password field is the last one, in which case the form is submitted.

Specified by:
actionPerformed in interface ActionListener
Parameters:
ev - the action event

submitData

protected void submitData(String data)
Submits the form data. A separate thread is created to do the transmission.

Parameters:
data - the form data

imageSubmit

protected void imageSubmit(String imageData)
Submits the form data in response to a click on a <input type="image"> element.

Parameters:
imageData - the mouse click coordinates