Класс 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, type button	JButton
input, type checkbox	JCheckBox
input, type image	JButton
input, type password	JPasswordField
input, type radio	JRadioButton
input, type reset	JButton
input, type submit	JButton
input, type text	JTextField
select, размер > 1 или определён атрибут multiple	JList в JScrollPane
select, размер не указан или 1	JComboBox
textarea	JTextArea в JScrollPane
input, type file	JTextField

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

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

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

Модификатор и тип	Поле	Описание
`static final String`	`RESET`	Устарело. С версии 1.3 значение берётся из свойства UIManager UIManager property FormView.resetButtonText
`static final 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

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

RESET

@Deprecated public static final String RESET

Устарело.

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

Если для элемента FORM input типа "reset" не задано значение атрибута, используется эта строка по умолчанию.

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

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, 2023, 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/21/docs/api/java.desktop/javax/swing/text/html/FormView.html