Класс 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, size > 1 or multiple attribute defined	JList in a JScrollPane
select, size unspecified or 1	JComboBox
textarea	JTextArea in a JScrollPane
input, type 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

Модификатор и тип	Поле	Описание
`static final int`	`BadBreakWeight`	Вес, указывающий, что представление является неподходящим местом для переноса при форматировании.
`static final int`	`ExcellentBreakWeight`	Вес, указывающий, что представление поддерживает перенос и является очень подходящим местом для него.
`static final int`	`ForcedBreakWeight`	Вес, указывающий, что представление поддерживает перенос и должно быть перенесено, чтобы правильно отображаться в представлении, которое форматирует дочерние элементы посредством переноса.
`static final int`	`GoodBreakWeight`	Вес, указывающий, что представление поддерживает перенос, хотя, вероятно, существуют более подходящие места для него.
`static final int`	`X_AXIS`	Ось для операций форматирования и переноса.
`static final int`	`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

Модификатор и тип	Поле	Описание
`static final int`	`BOTTOM`	Константа ориентации блока, обозначающая его нижнюю сторону.
`static final int`	`CENTER`	Центральная позиция в области.
`static final int`	`EAST`	Направление по компасу: восток (вправо).
`static final int`	`HORIZONTAL`	Горизонтальная ориентация.
`static final int`	`LEADING`	Обозначает начальный край текста для языков с письмом слева направо и справа налево.
`static final int`	`LEFT`	Константа ориентации блока, обозначающая его левую сторону.
`static final int`	`NEXT`	Обозначает следующее направление в последовательности.
`static final int`	`NORTH`	Направление по компасу: север (вверх).
`static final int`	`NORTH_EAST`	Направление по компасу: северо-восток (вверху справа).
`static final int`	`NORTH_WEST`	Направление по компасу: северо-запад (вверху слева).
`static final int`	`PREVIOUS`	Обозначает предыдущее направление в последовательности.
`static final int`	`RIGHT`	Константа ориентации блока, обозначающая его правую сторону.
`static final int`	`SOUTH`	Направление по компасу: юг (вниз).
`static final int`	`SOUTH_EAST`	Направление по компасу: юго-восток (внизу справа).
`static final int`	`SOUTH_WEST`	Направление по компасу: юго-запад (внизу слева).
`static final int`	`TOP`	Константа ориентации блока, обозначающая его верхнюю сторону.
`static final int`	`TRAILING`	Обозначает конечный край текста для языков с письмом слева направо и справа налево.
`static final int`	`VERTICAL`	Вертикальная ориентация.
`static final int`	`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

Модификатор и тип	Метод	Описание
`float`	`getAlignment(int axis)`	Определяет желаемое выравнивание данного представления вдоль оси.
`final Component`	`getComponent()`	Возвращает компонент, связанный с представлением.
`float`	`getMinimumSpan(int axis)`	Определяет минимальный размер данного представления вдоль оси.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительный размер данного представления вдоль оси.
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Обеспечивает отображение координат модели в координаты представления.
`void`	`paint(Graphics g, Shape a)`	Фактическая отрисовка выполняется автоматически благодаря связи компонента с его родительским контейнером (тем же контейнером, в котором размещено это представление).
`void`	`setParent(View p)`	Задаёт родительское представление для дочернего.
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] bias)`	Обеспечивает отображение координат представления в логические координаты модели.

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

Модификатор и тип	Метод	Описание
`void`	`append(View v)`	Добавляет одно дочернее представление.
`View`	`breakView(int axis, int offset, float pos, float len)`	Пытается перенести это представление вдоль указанной оси.
`void`	`changedUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Документ уведомляет об изменении атрибутов в области, за которую отвечает это представление.
`View`	`createFragment(int p0, int p1)`	Создаёт представление, отображающее часть элемента.
`protected void`	`forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)`	Пересылает заданное `DocumentEvent` дочерним представлениям, которые должны получить уведомление об изменении модели.
`protected void`	`forwardUpdateToView(View v, DocumentEvent e, Shape a, ViewFactory f)`	Пересылает `DocumentEvent` заданному дочернему представлению.
`AttributeSet`	`getAttributes()`	Получает атрибуты, используемые при отрисовке.
`int`	`getBreakWeight(int axis, float pos, float len)`	Определяет, насколько подходит это представление для переноса.
`Shape`	`getChildAllocation(int index, Shape a)`	Получает область размещения заданного дочернего представления.
`Container`	`getContainer()`	Получает контейнер, в котором размещено представление.
`Document`	`getDocument()`	Получает модель, связанную с представлением.
`Element`	`getElement()`	Получает структурную часть объекта, с которой сопоставлено это представление.
`int`	`getEndOffset()`	Получает часть модели, за которую отвечает это представление.
`Graphics`	`getGraphics()`	Получает `Graphics` для отрисовки.
`int`	`getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Позволяет определить следующую визуально представленную позицию модели, в которой можно разместить каретку.
`View`	`getParent()`	Возвращает родительское представление.
`int`	`getResizeWeight(int axis)`	Определяет возможность изменения размера представления вдоль заданной оси.
`int`	`getStartOffset()`	Получает часть модели, за которую отвечает это представление.
`String`	`getToolTipText(float x, float y, Shape allocation)`	Возвращает текст всплывающей подсказки в указанной позиции.
`View`	`getView(int n)`	Возвращает дочернее представление с индексом n.
`int`	`getViewCount()`	Возвращает количество представлений в этом представлении.
`ViewFactory`	`getViewFactory()`	Получает реализацию `ViewFactory`, обеспечивающую иерархию представлений.
`int`	`getViewIndex(float x, float y, Shape allocation)`	Возвращает индекс дочернего представления, соответствующего заданной позиции в представлении.
`int`	`getViewIndex(int pos, Position.Bias b)`	Возвращает индекс дочернего представления, соответствующего заданной позиции в модели.
`void`	`insert(int offs, View v)`	Вставляет одно дочернее представление.
`void`	`insertUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Уведомляет о вставке данных в документ в области, за которую отвечает это представление.
`boolean`	`isVisible()`	Возвращает логическое значение, указывающее, является ли представление видимым.
`Shape`	`modelToView(int pos, Shape a)`	Устарело.
`Shape`	`modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a)`	Обеспечивает отображение координат модели документа в координаты представления для заданной области.
`void`	`preferenceChanged(View child, boolean width, boolean height)`	Дочерние представления могут вызвать этот метод у родительского, чтобы сообщить об изменении предпочтительных параметров, требующем повторного выполнения компоновки.
`void`	`remove(int i)`	Удаляет одного из дочерних элементов в заданной позиции.
`void`	`removeAll()`	Удаляет все дочерние элементы.
`void`	`removeUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Уведомляет об удалении данных из документа в области, за которую отвечает это представление.
`void`	`replace(int offset, int length, View[] views)`	Заменяет дочерние представления.
`void`	`setSize(float width, float height)`	Задаёт размер представления.
`protected boolean`	`updateChildren(DocumentEvent.ElementChange ec, DocumentEvent e, ViewFactory f)`	Обновляет дочерние представления в ответ на уведомление об изменении модели, если запись об изменении относится к элементу, за который отвечает это представление.
`protected void`	`updateLayout(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a)`	Обновляет компоновку в ответ на уведомление об изменении модели.
`int`	`viewToModel(float x, float y, Shape a)`	Устарело.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно вследствие вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно вследствие вызова метода notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно вследствие вызова метода notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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.