Класс FieldView

javax.swing.text.FieldView

Все реализованные интерфейсы:: SwingConstants, TabExpander

Прямые известные подклассы:: PasswordView

public class FieldView extends PlainView

Расширяет представление многострочного простого текста, адаптируя его для однострочного редактора. Если представлению выделено дополнительное пространство, поле должно подстроиться под него. Если компонентом-хозяином является JTextField, это представление будет управлять диапазонами связанной модели BoundedRangeModel и корректировать горизонтальную область размещения в соответствии с текущими настройками видимости JTextField.

См. также:

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

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

metrics

Модификатор и тип	Поле	Описание
`protected FontMetrics`	`metrics`	Метрики шрифта для текущего шрифта.

Поля, объявленные в классе 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`	Направление по компасу: запад (влево).

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

Конструктор	Описание
`FieldView(Element elem)`	Создает новое представление FieldView, связанное с элементом.

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

Модификатор и тип	Метод	Описание
`protected Shape`	`adjustAllocation(Shape a)`	Корректирует область размещения, выделенную представлению, чтобы она подходила для текстового поля.
`protected FontMetrics`	`getFontMetrics()`	Получает метрики шрифта, связанные с компонентом, в котором размещено это представление.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительный размер представления вдоль заданной оси.
`int`	`getResizeWeight(int axis)`	Определяет возможность изменения размера представления вдоль заданной оси.
`void`	`insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Уведомляет о вставке данных в документ в области, за которую отвечает это представление.
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Преобразует координаты модели документа в координаты соответствующего ей представления.
`void`	`paint(Graphics g, Shape a)`	Отображает содержимое с использованием заданной поверхности и области на этой поверхности.
`void`	`removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Уведомляет об удалении данных из документа в области, за которую отвечает это представление.
`int`	`viewToModel(float fx, float fy, Shape a, Position.Bias[] bias)`	Преобразует координаты представления в логические координаты модели.

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

changedUpdate, damageLineRange, drawLine, drawLine, drawSelectedText, drawSelectedText, drawUnselectedText, drawUnselectedText, getLineBuffer, getTabSize, lineToRect, nextTabStop, setSize, updateDamage, updateMetrics

Модификатор и тип	Метод	Описание
`void`	`changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Уведомляет от документа об изменении атрибутов в области, за которую отвечает это представление.
`protected void`	`damageLineRange(int line0, int line1, Shape a, Component host)`	Перерисовывает заданный диапазон строк.
`protected void`	`drawLine(int lineIndex, Graphics2D g, float x, float y)`	Отображает строку текста, убирая пробелы в конце и раскрывая табуляции.
`protected void`	`drawLine(int lineIndex, Graphics g, int x, int y)`	Устарело. заменено на `PlainView.drawLine(int, Graphics2D, float, float)`
`protected float`	`drawSelectedText(Graphics2D g, float x, float y, int p0, int p1)`	Отображает заданный диапазон модели как выделенный текст.
`protected int`	`drawSelectedText(Graphics g, int x, int y, int p0, int p1)`	Устарело. заменено на `PlainView.drawSelectedText(Graphics2D, float, float, int, int)`
`protected float`	`drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1)`	Отображает заданный диапазон модели как обычный невыделенный текст.
`protected int`	`drawUnselectedText(Graphics g, int x, int y, int p0, int p1)`	Устарело. заменено на `PlainView.drawUnselectedText(Graphics2D, float, float, int, int)`
`protected final Segment`	`getLineBuffer()`	Предоставляет доступ к буферу, который можно использовать для получения текста из связанного документа.
`protected int`	`getTabSize()`	Возвращает размер табуляции, заданный для документа; по умолчанию он равен 8.
`protected Rectangle`	`lineToRect(Shape a, int line)`	Определяет прямоугольник, соответствующий заданной строке.
`float`	`nextTabStop(float x, int tabOffset)`	Возвращает позицию следующей табуляции после заданной исходной позиции.
`void`	`setSize(float width, float height)`	Задает размер представления.
`protected void`	`updateDamage(DocumentEvent changes, Shape a, ViewFactory f)`	Перерисовывает изменившуюся область, охватываемую заданным событием документа.
`protected void`	`updateMetrics()`	Проверяет, актуальны ли метрики шрифта и самая длинная строка.

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

append, breakView, createFragment, forwardUpdate, forwardUpdateToView, getAlignment, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, updateChildren, updateLayout, viewToModel

Модификатор и тип	Метод	Описание
`void`	`append(View v)`	Добавляет одно дочернее представление.
`View`	`breakView(int axis, int offset, float pos, float len)`	Пытается перенести это представление вдоль заданной оси.
`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` указанному дочернему представлению.
`float`	`getAlignment(int axis)`	Определяет желаемое выравнивание этого представления вдоль оси.
`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` для отображения.
`float`	`getMaximumSpan(int axis)`	Определяет максимальный размер этого представления вдоль оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальный размер этого представления вдоль оси.
`int`	`getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Позволяет определить следующее визуально представленное положение модели, в котором можно разместить курсор.
`View`	`getParent()`	Возвращает родительское представление.
`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)`	Вставляет одно дочернее представление.
`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`	`replace(int offset, int length, View[] views)`	Заменяет дочерние представления.
`void`	`setParent(View parent)`	Задает родительское представление для этого представления.
`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, либо до истечения заданного периода реального времени.

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

FieldView

public FieldView(Element elem)

Создает новое представление FieldView, связанное с элементом.

Параметры:: elem — элемент

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

getFontMetrics

protected FontMetrics getFontMetrics()

Получает метрики шрифта, связанные с компонентом, в котором размещено это представление.

Возвращает:: метрики

adjustAllocation

protected Shape adjustAllocation(Shape a)

Корректирует область размещения, выделенную представлению, чтобы она подходила для текстового поля. Если вертикальный размер выделенной области превышает предпочтительный размер представления, область корректируется так, чтобы представление располагалось по вертикали по центру. По горизонтали представление корректируется согласно свойству горизонтального выравнивания связанного JTextField (если это компонент-хозяин соответствующего типа).

Параметры:: a — область размещения, выделенная представлению; возможно, ее потребуется скорректировать.
Возвращает:: область размещения, которую должен использовать суперкласс.

paint

public void paint(Graphics g, Shape a)

Отображает содержимое с использованием заданной поверхности и области на этой поверхности. Для отображения в выделенной области представлению может потребоваться выполнить компоновку и создать дочерние представления.

Переопределяет:

paint в классе PlainView

Параметры:

g — используемая поверхность отображения

a — выделенная область для отображения

См. также:

getPreferredSpan

public float getPreferredSpan(int axis)

Определяет предпочтительный размер представления вдоль заданной оси.

Переопределяет:: getPreferredSpan в классе PlainView
Параметры:: axis — может быть View.X_AXIS или View.Y_AXIS
Возвращает:: размер области, в которой представление предпочло бы отображаться (>= 0). Обычно представлению предписывается отображаться в области возвращаемого размера, однако это не гарантируется. Родительское представление может изменить размер или выполнить перенос.

getResizeWeight

public int getResizeWeight(int axis)

Определяет возможность изменения размера представления вдоль заданной оси. Значение 0 или меньше означает, что размер изменить нельзя.

Переопределяет:: getResizeWeight в классе View
Параметры:: axis — View.X_AXIS или View.Y_AXIS
Возвращает:: вес: 1 для View.X_AXIS, иначе 0

modelToView

public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException

Преобразует координаты модели документа в координаты соответствующего ей представления.

Переопределяет:

modelToView в классе PlainView

Параметры:

pos — позиция для преобразования (>= 0)

a — выделенная область для отображения

b — смещение в сторону предыдущего или следующего символа, представленного смещением, если позиция находится на границе двух представлений; b может принимать одно из следующих значений:

Position.Bias.Forward
Position.Bias.Backward

Возвращает:

ограничивающий прямоугольник заданной позиции

Вызывает исключение:

BadLocationException — если заданная позиция не соответствует допустимому месту в связанном документе

См. также:

viewToModel

public int viewToModel(float fx, float fy, Shape a, Position.Bias[] bias)

Преобразует координаты представления в логические координаты модели.

Переопределяет:

viewToModel в классе PlainView

Параметры:

fx — координата X (>= 0.0f)

fy — координата Y (>= 0.0f)

a — выделенная область для отображения

bias — возвращаемое смещение

Возвращает:

положение в модели, наилучшим образом соответствующее заданной точке в представлении

См. также:

insertUpdate

public void insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)

Уведомляет о вставке данных в документ в области, за которую отвечает это представление.

Переопределяет:

insertUpdate в классе PlainView

Параметры:

changes — сведения об изменении из связанного документа

a — текущая область размещения представления

f — фабрика для перестроения, если у представления есть дочерние элементы

См. также:

removeUpdate

public void removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)

Уведомляет об удалении данных из документа в области, за которую отвечает это представление.

Переопределяет:

removeUpdate в классе PlainView

Параметры:

changes — сведения об изменении из связанного документа

a — текущая область размещения представления

f — фабрика для перестроения, если у представления есть дочерние элементы

См. также:

© 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.