Module java.desktop

Package javax.swing.text.html

Class FormView

java.lang.Object

javax.swing.text.View

javax.swing.text.ComponentView

javax.swing.text.html.FormView

所有已实现的接口:

ActionListener, EventListener, SwingConstants

       public class FormView extends ComponentView implements ActionListener
      

实现表单元素视图接口的组件装饰器，包括<input>、<textarea>和<select>。组件的模型存储为元素的属性（使用StyleConstants.ModelAttribute），并用于构建视图的组件。模型的类型假定为HTMLDocument.HTMLReader.FormAction设置的类型。如果在文档上映射了多个视图，则它们将共享嵌入式组件模型。

以下表格显示了此视图构建的组件。

显示此视图构建的组件

元素类型	构建的组件
input, 类型为button	JButton
input, 类型为checkbox	JCheckBox
input, 类型为image	JButton
input, 类型为password	JPasswordField
input, 类型为radio	JRadioButton
input, 类型为reset	JButton
input, 类型为submit	JButton
input, 类型为text	JTextField
select, size > 1 或定义了multiple属性	JList in a JScrollPane
select, 大小未指定或为1	JComboBox
textarea	JTextArea in a JScrollPane
input, 类型为file	JTextField

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	FormView.MouseEventListener	处理当点击类型为image的输入时提交表单的MouseEventListener类。

Field Summary

Fields

Modifier and Type	Field	Description
static final String	RESET	已弃用。 从1.3版本开始，值来自UIManager属性FormView.resetButtonText
static final String	SUBMIT	已弃用。 从1.3版本开始，值现在来自UIManager属性FormView.submitButtonText

Fields declared in class javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Fields declared in 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

Constructors

Constructor	Description
FormView(Element elem)	创建一个新的FormView对象。

Method Summary

Modifier and Type	Method	Description
void	actionPerformed(ActionEvent evt)	负责处理ActionEvent。
protected Component	createComponent()	创建组件。
float	getMaximumSpan(int axis)	确定此视图沿某个轴的最大跨度。
protected void	imageSubmit(String imageData)	在响应图像点击时提交表单的方法。-- 类型为"image"的<INPUT>表单元素。
protected void	submitData(String data)	此方法负责提交表单数据。

Methods declared in class javax.swing.text.ComponentView

getAlignment, getComponent, getMinimumSpan, getPreferredSpan, modelToView, paint, setParent, viewToModel

Methods declared in class javax.swing.text.View

append, breakView, changedUpdate, createFragment, 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 declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

SUBMIT

             @Deprecated public static final String SUBMIT
            

Deprecated.

As of 1.3, value now comes from UIManager property FormView.submitButtonText

如果未为类型为"submit"的FORM输入元素指定value属性，则使用此默认字符串。

RESET

             @Deprecated public static final String RESET
            

Deprecated.

As of 1.3, value comes from UIManager UIManager property FormView.resetButtonText

如果未为类型为"reset"的FORM输入元素指定value属性，则使用此默认字符串。

Constructor Details

FormView

             public FormView(Element elem)
            

创建一个新的FormView对象。

参数:

elem - 要装饰的元素

Method Details

createComponent

             protected Component createComponent()
            

创建组件。基本上是一个基于标签类型和相关元素的html属性的大型switch语句。

覆盖:

createComponent 在类 ComponentView

返回:

与此视图关联的组件

getMaximumSpan

             public float getMaximumSpan(int axis)
            

确定此视图沿某个轴的最大跨度。对于某些组件，最大跨度和首选跨度相同。对于其他组件，沿感兴趣的轴返回Component.getMaximumSize返回的值。

覆盖:

getMaximumSpan 在类 ComponentView

参数:

axis - 可以是View.X_AXIS或View.Y_AXIS

返回:

视图希望呈现的跨度 >= 0。通常告诉视图呈现返回的跨度，尽管不能保证。父级可能选择调整或分割视图。

抛出:

IllegalArgumentException - 对于无效的轴

参见:

• View.getPreferredSpan(int)

actionPerformed

             public void actionPerformed(ActionEvent evt)
            

负责处理ActionEvent。如果与FormView关联的元素的类型为"submit"、"reset"、"text"或"password"，则处理操作。在"submit"的情况下，提交表单。在"reset"的情况下，将表单重置为其原始状态。在"text"或"password"的情况下，如果元素是最后一个"text"或"password"类型，则提交表单。否则，焦点转移到表单中的下一个组件。

指定者:

actionPerformed 在接口 ActionListener

参数:

evt - ActionEvent。

submitData

             protected void submitData(String data)
            

此方法负责提交表单数据。将启动一个线程来执行提交。

参数:

data - 要提交的数据

imageSubmit

             protected void imageSubmit(String imageData)
            

在响应图像点击时提交表单的方法。-- 类型为"image"的<INPUT>表单元素。

参数:

imageData - 鼠标点击坐标。