Класс 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)

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

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

viewToModel в классе View

Параметры:

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

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

a - область для отображения

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

Возвращает:

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

См. также:

insertUpdate

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

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

Overrides:

insertUpdate в классе View

Параметры:

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

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

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

См. также:

removeUpdate

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

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

Overrides:

removeUpdate в классе View

Параметры:

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

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

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

См. также:

changedUpdate

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

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

Overrides:

changedUpdate в классе View

Параметры:

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

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

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

См. также:

setSize

public void setSize(float width, float height)

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

Overrides:: setSize в классе View
Параметры:: width - ширина >= 0; height - высота >= 0

nextTabStop

public float nextTabStop(float x, int tabOffset)

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

Specified by:: nextTabStop в интерфейсе TabExpander
Параметры:: x - текущее положение >= 0; tabOffset - положение в потоке текста, в котором произошла табуляция >= 0.
Возвращает:: остановку табуляции, измеренную в пунктах >= 0

updateDamage

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

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

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

damageLineRange

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

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

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

lineToRect

protected Rectangle lineToRect(Shape a, int line)

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

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

© 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/PlainView.html