Класс FieldView

javax.swing.text.FieldView

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

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

public class FieldView extends PlainView

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

См. также:

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

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

metrics

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

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

Конструктор	Описание
`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

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

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

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/FieldView.html