Класс FormView

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 в JScrollPane
select, size не задан или равен 1	JComboBox
textarea	JTextArea в JScrollPane
input, тип file	JTextField

Краткое описание вложенных классов

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

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`RESET`	Устарело. Начиная с версии 1.3 значение берётся из свойства UIManager FormView.resetButtonText
`static final String`	`SUBMIT`	Устарело. Начиная с версии 1.3 значение берётся из свойства UIManager FormView.submitButtonText

Поля, объявленные в классе View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Поля, объявленные в интерфейсе 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)`	Этот метод отвечает за отправку данных формы.

Методы, объявленные в классе ComponentView

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

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

Методы, объявленные в классе Object

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

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

SUBMIT

@Deprecated public static final String SUBMIT

Устарело.

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

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

RESET

@Deprecated public static final String RESET

Устарело.

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

Если для элемента ввода формы FORM типа "reset" не задан атрибут 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 — если указана недопустимая ось

См. также:

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)

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

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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/html/FormView.html