Класс PlainView

java.lang.Object

javax.swing.text.View

javax.swing.text.PlainView

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

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

public class PlainView extends View implements TabExpander

Реализует интерфейс View для простого многострочного текстового представления, имеющего текст в одном шрифте и цвете. Представление отображает каждый дочерний элемент как строку текста.

См. также:

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

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

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

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

Конструктор	Описание
`PlainView(Element elem)`	Создает новый PlainView, обернутый вокруг элемента.

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

Модификатор и тип	Метод	Описание
`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)`	Устарело. заменено на `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)`	Устарело. заменено на `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)`	Устарело. заменено на `drawUnselectedText(Graphics2D, float, float, int, int)`
`protected final Segment`	`getLineBuffer()`	Предоставляет доступ к буферу, который можно использовать для извлечения текста из связанного документа.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительный размер для этого представления по оси.
`protected int`	`getTabSize()`	Возвращает размер отступа табуляции, установленный для документа, по умолчанию 8.
`void`	`insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Предоставляет уведомление о том, что что-то было вставлено в документ в расположении, за которое отвечает это представление.
`protected Rectangle`	`lineToRect(Shape a, int line)`	Определяет прямоугольник, представляющий данную строку.
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Предоставляет отображение из координатного пространства модели документа в координатное пространство представления, сопоставленного с ним.
`float`	`nextTabStop(float x, int tabOffset)`	Возвращает следующую позицию отступа табуляции после заданной опорной позиции.
`void`	`paint(Graphics g, Shape a)`	Отображает с помощью заданной поверхности отрисовки и области на этой поверхности.
`void`	`removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Предоставляет уведомление о том, что что-то было удалено из документа в расположении, за которое отвечает это представление.
`void`	`setSize(float width, float height)`	Устанавливает размер представления.
`protected void`	`updateDamage(DocumentEvent changes, Shape a, ViewFactory f)`	Перерисовывает область изменений, охваченную заданным событием документа.
`protected void`	`updateMetrics()`	Проверяет, являются ли метрики шрифта и самая длинная строка актуальными.
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] bias)`	Предоставляет отображение из координатного пространства представления в логическое координатное пространство модели.

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

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

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

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

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

metrics

protected FontMetrics metrics

Метрики шрифта для текущего шрифта.

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

PlainView

public PlainView(Element elem)

Создаёт новый PlainView, обернутый вокруг элемента.

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

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

getTabSize

protected int getTabSize()

Возвращает размер табуляции, установленный для документа, по умолчанию 8.

Возвращает:: размер табуляции

drawLine

@Deprecated(since="9") protected void drawLine(int lineIndex, Graphics g, int x, int y)

Устарело.

заменено на drawLine(int, Graphics2D, float, float)

Отображает строку текста, подавляя пробелы в конце и расширяя табуляции. Реализовано для вызовов методов drawUnselectedText и drawSelectedText, чтобы можно было настроить отображение выделенного и невыделенного текста.

Параметры:

lineIndex - строка для отображения >= 0

g - контекст Graphics

x - начальная позиция X >= 0

y - начальная позиция Y >= 0

См. также:

drawLine

protected void drawLine(int lineIndex, Graphics2D g, float x, float y)

Параметры:

lineIndex - строка для отображения >= 0

g - контекст Graphics

x - начальная позиция X >= 0

y - начальная позиция Y >= 0

С тех пор как:

См. также:

drawUnselectedText

@Deprecated(since="9") protected int drawUnselectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException

Устарело.

заменено на drawUnselectedText(Graphics2D, float, float, int, int)

Отображает заданный диапазон в модели как обычный невыделенный текст. Использует цвет переднего плана или отключённый цвет для отображения текста.

Параметры:: g - контекст графики; x - начальная координата X >= 0; y - начальная координата Y >= 0; p0 - начальная позиция в модели >= 0; p1 - конечная позиция в модели >= 0
Возвращает:: положение X конца диапазона >= 0
Исключения:: BadLocationException - если диапазон некорректен

drawUnselectedText

protected float drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1) throws BadLocationException

Параметры:: g - контекст графики; x - начальная координата X >= 0; y - начальная координата Y >= 0; p0 - начальная позиция в модели >= 0; p1 - конечная позиция в модели >= 0
Возвращает:: положение X конца диапазона >= 0
Исключения:: BadLocationException - если диапазон некорректен
С тех пор как:: 9

drawSelectedText

@Deprecated(since="9") protected int drawSelectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException

Устарело.

заменено на drawSelectedText(Graphics2D, float, float, int, int)

Отображает заданный диапазон в модели как выделенный текст. Реализовано для отображения текста в цвете, указанном в родительском компоненте. Предполагается, что выделение фона будет выполнено инструментом подсветки.

Параметры:: g - контекст графики; x - начальная координата X >= 0; y - начальная координата Y >= 0; p0 - начальная позиция в модели >= 0; p1 - конечная позиция в модели >= 0
Возвращает:: положение конца диапазона
Исключения:: BadLocationException - если диапазон некорректен

drawSelectedText

protected float drawSelectedText(Graphics2D g, float x, float y, int p0, int p1) throws BadLocationException

Параметры:: g - контекст графики; x - начальная координата X >= 0; y - начальная координата Y >= 0; p0 - начальная позиция в модели >= 0; p1 - конечная позиция в модели >= 0
Возвращает:: положение конца диапазона
Исключения:: BadLocationException - если диапазон некорректен
С тех пор как:: 9

getLineBuffer

protected final Segment getLineBuffer()

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

Возвращает:: буфер

updateMetrics

protected void updateMetrics()

Проверяет, обновлены ли метрики шрифта и самая длинная строка.

С тех пор как:: 1.4

getPreferredSpan

public float getPreferredSpan(int axis)

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

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

paint

public void paint(Graphics g, Shape a)

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

Определено в:

paint в классе View

Параметры:

g - поверхность отрисовки для использования

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

См. также:

modelToView

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

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

Определено в:

modelToView в классе View

Параметры:

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

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

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

Position.Bias.Forward
Position.Bias.Backward

Возвращает:

область расположения заданной позиции

Исключения:

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

См. также:

viewToModel

public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)

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

Specified by:

viewToModel in class View

Parameters:

x - координата X >= 0

y - координата Y >= 0

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

bias - возвращённый сдвиг

Returns:

положение в модели, которое лучше всего представляет заданную точку в представлении >= 0

See Also:

insertUpdate

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

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

Overrides:

insertUpdate in class View

Parameters:

changes - информация о изменении из связанного документа

a - текущее выделение представления

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

See Also:

removeUpdate

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

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

Overrides:

removeUpdate in class View

Parameters:

changes - информация о изменении из связанного документа

a - текущее выделение представления

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

See Also:

changedUpdate

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

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

Overrides:

changedUpdate in class View

Parameters:

changes - информация о изменении из связанного документа

a - текущее выделение представления

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

See Also:

setSize

public void setSize(float width, float height)

Устанавливает размер представления. Это должно вызвать размещение представления вдоль заданной оси, если у него есть какие-либо задачи размещения.

Overrides:: setSize in class View
Parameters:: width - ширина >= 0; height - высота >= 0

nextTabStop

public float nextTabStop(float x, int tabOffset)

Возвращает следующее положение табуляции после заданного справочного положения. Эта реализация не поддерживает такие вещи, как центрирование, поэтому она игнорирует аргумент tabOffset.

Specified by:: nextTabStop in interface TabExpander
Parameters:: x - текущее положение >= 0; tabOffset - положение в потоке текста, где произошла табуляция >= 0.
Returns:: позиция табуляции, измеренная в пунктах >= 0

updateDamage

protected void updateDamage(DocumentEvent changes, Shape a, ViewFactory f)

Перерисовывает область изменения, охватываемую заданным событием документа. Повреждает строку, которая начинается с диапазона, чтобы учесть случай, когда вставка/удаление находится только на одной строке. Если строки добавляются или удаляются, повреждает всё представление. Проверяется самая длинная строка, чтобы определить, изменилась ли она.

Parameters:: changes - информация о изменении из связанного документа; a - текущее выделение представления; f - фабрика для использования при перестроении, если у представления есть дочерние элементы
Since:: 1.4

damageLineRange

protected void damageLineRange(int line0, int line1, Shape a, Component host)

Перерисовывает заданный диапазон строк.

Parameters:: line0 - начальный номер строки для перерисовки. Он должен быть допустимым номером строки в модели.; line1 - конечный номер строки для перерисовки. Он должен быть допустимым номером строки в модели.; a - выделенная область для отрисовки представления; host - компонент, размещающий представление (используется для вызова repaint)
Since:: 1.4

lineToRect

protected Rectangle lineToRect(Shape a, int line)

Определяет прямоугольник, представляющий заданную строку.

Parameters:: a - выделенная область для отрисовки представления; line - номер строки, для которой нужно найти область. Он должен быть допустимым номером строки в модели.
Returns:: прямоугольник, представляющий заданную строку
Since:: 1.4

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/PlainView.html