Класс 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, Graphics g, int x, int y)` Отображает строку текста, подавляя пробелы в конце и расширяя табуляции.
`protected int`	`drawSelectedText(Graphics g, int x, int y, int p0, int p1)` Отображает заданный диапазон в модели как выделенный текст.
`protected int`	`drawUnselectedText(Graphics g, int x, int y, int p0, int p1)` Отображает заданный диапазон в модели как обычный невыделенный текст.
`protected 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 fx, float fy, 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

protected void drawLine(int lineIndex,
                        Graphics g,
                        int x,
                        int y)

Отображает строку текста, подавляя пробелы в конце и расширяя табуляции. Этот метод реализован для вызовов методов 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)

drawUnselectedText

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

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

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

drawSelectedText

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

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

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

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 - для неверной оси
См. также:: View.getPreferredSpan(int)

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 fx,
                       float fy,
                       Shape a,
                       Position.Bias[] bias)

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

Задано в:: viewToModel в классе View
Параметры:: fx - координата X >= 0; fy - координата Y >= 0; a - выделенная область для отрисовки
Возвращает:: местоположение в модели, которое наилучшим образом представляет заданную точку в представлении >= 0
См. также:: View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

insertUpdate

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

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

Переопределяет:: 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)

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

Переопределяет:: 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)

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

Переопределяет:: 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)

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

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

nextTabStop

public float nextTabStop(float x,
                         int tabOffset)

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

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

updateDamage

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

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

С:: 1.4

damageLineRange

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

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

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

lineToRect

protected Rectangle lineToRect(Shape a,
                               int line)

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

Параметры:: a - область, выделенная для отрисовки представления; line - номер строки, для которой необходимо найти область. Должен быть корректным номером строки в модели.
С:: 1.4

© 1993, 2020, 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.