Класс 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, тип кнопка	JButton
input, тип флажок	JCheckBox
input, тип изображение	JButton
input, тип пароль	JPasswordField
input, тип радиокнопка	JRadioButton
input, тип сброс	JButton
input, тип отправка	JButton
input, тип текст	JTextField
select, размер > 1 или определён атрибут multiple	JList в JScrollPane
select, размер не указан или 1	JComboBox
textarea	JTextArea в JScrollPane
input, тип файл	JTextField

Вложенные классы

Модификатор и тип	Класс	Описание
`protected class`	`FormView.MouseEventListener`	Класс MouseEventListener для обработки отправки формы при нажатии на элемент input с типом изображения.

Поля

Модификатор и тип Поле Описание

static String

RESET

Устарело.

Начиная с 1.3, значение берется из свойства UIManager FormView.resetButtonText

static String

SUBMIT

Устарело.

Начиная с 1.3, значение теперь берется из свойства UIManager FormView.submitButtonText

Поля, унаследованные от класса javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Поля, унаследованные от интерфейса 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

Краткое описание конструкторов

Конструктор	Описание
`FormView(Element elem)`	Создает новый объект FormView.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`actionPerformed(ActionEvent evt)`	Ответственный за обработку ActionEvent.
`protected Component`	`createComponent()`	Создаёт компонент.
`float`	`getMaximumSpan(int axis)`	Определяет максимальный размер для этого представления вдоль оси.
`protected void`	`imageSubmit(String imageData)`	Этот метод вызывается для отправки формы в ответ на щелчок по изображению — элементу формы <INPUT> типа "image".
`protected void`	`submitData(String data)`	Этот метод отвечает за отправку данных формы.

Методы, унаследованные от класса javax.swing.text.ComponentView

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

Методы, унаследованные от класса 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

Методы, унаследованные от класса java.lang.Object

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

Подробное описание полей

SUBMIT

@Deprecated
public static final String SUBMIT

Устарело.

Начиная с 1.3, значение теперь берется из свойства UIManager FormView.submitButtonText

Если для элемента формы INPUT типа "отправить" не задано значение атрибута value, то используется эта строка по умолчанию.

RESET

@Deprecated
public static final String RESET

Устарело.

Начиная с 1.3, значение берется из свойства UIManager UIManager property FormView.resetButtonText

Если для элемента формы INPUT типа "сброс" не задано значение атрибута value, то используется эта строка по умолчанию.

Подробное описание конструкторов

FormView

public FormView(Element elem)

Создает новый объект FormView.

Параметры:: elem - элемент для декорации

Подробное описание методов

createComponent

protected Component createComponent()

Создаёт компонент. Это в основном большой оператор switch, основанный на типе тега и атрибутах HTML соответствующего элемента.

Переопределяет:: 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, имеет тип "отправить", "сброс", "текст" или "пароль", то действие обрабатывается. В случае "отправить" форма отправляется. В случае "сброс" форма сбрасывается до исходного состояния. В случае "текст" или "пароль", если элемент является последним элементом типа "текст" или "пароль", форма отправляется. В противном случае фокус передается следующему компоненту в форме.

Определяет:: actionPerformed в интерфейсе ActionListener
Параметры:: evt - ActionEvent.

submitData

protected void submitData(String data)

Этот метод отвечает за отправку данных формы. Для выполнения отправки создаётся отдельный поток.

Параметры:: data - данные для отправки

imageSubmit

protected void imageSubmit(String imageData)

Этот метод вызывается для отправки формы в ответ на щелчок по изображению — элементу формы <INPUT> типа "image".

Параметры:: imageData - координаты щелчка мыши.