Класс PlainView

java.lang.Object

javax.swing.text.View

javax.swing.text.PlainView

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

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

public class PlainView extends View implements TabExpander

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

См. также:

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

См. также:

drawUnselectedText(java.awt.Graphics, int, int, int, int)
drawSelectedText(java.awt.Graphics, int, int, int, int)

drawLine

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

Параметры:

lineIndex - строка для отрисовки >= 0

g - контекст графического Graphics

x - начальная координата X >= 0

y - начальная координата Y >= 0

С:

См. также:

drawUnselectedText(java.awt.Graphics, int, int, int, int)
drawSelectedText(java.awt.Graphics, int, int, int, int)

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 - выделенная область для отрисовки

См. также:

View.paint(java.awt.Graphics, java.awt.Shape)

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 - если заданная позиция не представляет допустимое местоположение в связанном документе

См. также:

View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)

viewToModel

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

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

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

viewToModel в классе View

Параметры:

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

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

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

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

Возвращает:

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

См. также:

View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

insertUpdate

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

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

Overrides:

insertUpdate в классе View

Параметры:

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

a - текущее размещение вида

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

См. также:

View.insertUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

removeUpdate

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

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

Overrides:

removeUpdate в классе View

Параметры:

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

a - текущее размещение вида

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

См. также:

View.removeUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

changedUpdate

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

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

Overrides:

changedUpdate в классе View

Параметры:

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

a - текущее размещение вида

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

См. также:

View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

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 - фабрика для использования при перестроении, если у вида есть дочерние элементы
Since:: 1.4

damageLineRange

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

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

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

lineToRect

protected Rectangle lineToRect(Shape a, int line)

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

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

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/text/PlainView.html